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PREFACE 


This manual describes privileged supervisor call (SVC) facilities 
and other operating system features intended for use by system 
programmers, system analysts, designers, engineers, and training 
instructors. 


Chapter 1 presents an overview of the operating system and the 
software it supports. Chapter 2 describes the privileged task 
types supported by OS/32. Chapter 3 explains how to use the SVC 
O, SVC 2, SVC 6, SVC 7, and SVC 13 facilities for system level 
programming. Chapter 4 contains a functional description of the 
SVC interception feature. The vertical forms control (VFC) 
feature is described in Chapter 5 along with other device 
independent and dependent features supported by OS/32. Chapter 
6 describes the techniques used in writing system level control 
programs that take advantage of the increased throughput offered 
by a Perkin-Elmer Model 3200MPS System. 


The RO2 revision of this manual introduces enhancements to the 
OS/32 task manager for programming in a Model 3200MPS System 
multiprocessing environment. Features for efficient use of this 
expanded management ability include selection and assignment of 
tasks to specific processor units, rescheduling of tasks from one 
processor to another, and prevention of invalid data from 
concurrently running tasks. Real-time performance of individual 
tasks in the system is also measured. 


This manual is intended for use with the 0OS/32 RO7.1 software 
release or higher. Additional material that is specifically 
related to the Model 3200MPS System has been included. These 
Model 3200MPS System features are supported by the OS/32 RO7.1 
software release and higher. Throughout the text, these features 
are identified as applicable only to the Model 3200MPS System. 


For further information on the contents of all Perkin-Elmer 


32-bit manuals, see the 32-Bit Systems User Documentation 
Summary. . 
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CHAPTER 1 
0S/32 SUBSYSTEMS 


1.1 INTRODUCTION 


Perkin-Elmer OS/32 is a general purpose, event-driven operating 
system for Perkin-Elmer 32-bit computer systems. Custom versions 
of OS/32 are created through the use of a system generation 
program (SYSGEN/32) that provides parameters for tailoring OS/32 
to a specific installation. The combined hardware and software 
capabilities of a Perkin-Elmer 32-bit computer system provide 
support for all phases of program and system development. 05/32 
supports concurrent multiprogramming, with up to 252 user 
programs written in any of the supported languages. The program 
development facilities are designed to minimize the time and 
effort needed to test, debug, and integrate application programs 
and systems. In addition, the OS/32 command language allows 
complex jobs to be performed with minimum operator intervention. 


OS/32 incorporates a powerful interrupt handling capability at 
the task level. This capability permits a task to be interrupted 
during its normal execution sequence by a variety of hardware and 
software conditions. 


The OS/32 roll function and the virtual task manager (VT) allow 
the memory requirements of a task running under OS/32 to exceed 
available task memory. 


The roll function allows portions of a task to be rolled out to 
disk until enough memory is available for the entire task. In 
real-time applications, rolling is commonly used to queue _ low 
priority tasks while tasks of higher priority are active. The 
roll eligibility of a task is established when the task is link 
edited. However, a task option is provided to prevent roll of a 
task when necessary (e.g., when the task must be able to’ respond 
to real-time events). 


VTM is a user transparent virtual memory capability that allows 
tasks consisting of up to 16Mb of code and data to execute in as 
little as 128kb of memory. This feature is provided by the OS/32 
linkage editor. See the OS/32 Link Reference Manual for more 
information. 


A basic data communications facilities package is supplied with 


OS/32. This package also provides support for higher level 
Perkin-Elmer data communications products. 


48-040 FOO RO2 Lat 


The scope and power of the operating system can be extended 
through these Perkin-Elmer 0S/32 companion products: 


@e Multi-Terminal Monitor (MTM) 


@e Reliance 


MIM is a subsystem monitor that uses the subtasking capabilities 
of 0S/32 to provide a time-sliced, interactive program 
development environment for up to 64 concurrent terminal users. 
MIM simultaneously supports both online terminal users and batch 
background tasks. MTM terminal users are also provided with an 
input/output (1/0) spooler for use with slow speed devices. 


Reliance is a transaction software system, consisting of the 
Integrated Transaction Controller (ITC), Data Management System 
(DMS/32), and industry standard COBOL. ITC allocates system 
resources, develops screen formats, and controls terminals. 
DMS/32 supervises disk allocation and data access. 


1.1.1 O0OS/32 Multiprocessing Support 


0S/32 provides a transparent multiprocessing capability for use 
with the Perkin-Elmer Model 3200MPS System. This system consists 
of one central processing unit (CPU) and from _ one to nine 
auxiliary processing units (APUs). See Figure 1-l. A task can 
execute on an APU without any special preparation, unless it is 
going to take advantage of certain features specific to the 
multiprocessing system (e.g., APU mapping, APU control, etc.). 
See Chapter 3 for more information on these features. 


Each processor in a Model 3200MPS System has a unique identifying 
number. OS/32 uses the processor numbers to define a set of 
logical processing units (LPUs). Each LPU is mapped to one 
processor number through the logical processor mapp ing table 
(LPMT) . A task may execute on the processor that is mapped to 
the LPU assigned to the task. 


If a task is mainly compute intensive, executing that task on an 
APU increases overall system performance. An I/O intensive task, 
if directed to an APU, decreases system performance since each 
I/O request requires the task to be transferred back to the CPU 
for OS/32 I/O support services. 


The main performance advantage of a multiprocessing system is 
achieved when a problem is broken down into parts so that several 
tasks on several processors can work on the problem at the same 
time. See Chapter 6 for more information on programming from a 
Perkin-Elmer Model 3200MPS System environment. 
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Figure 1-1 Typical Model 3200MPS System Configuration 


1.2 SOFTWARE SUBSYSTEMS 


OS/32 consists of the following subsystems: 


Task management 

Job accounting 

Memory management 

Timer management 

File management 

Input/Output (1/0) management 
Error recording and reporting 
Memory diagnostics 

Loader and segmentation 

Basic communications 

Console monitor 

Command processor 

System initialization 
Internal interrupt 

Optional user supervisor call (SVC 14) 
Floating point 


Table 1-1 summarizes the software supported by OS/32. 
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TABLE 1-1 PERKIN-ELMER OS/32 SOFTWARE SUPPORT 


ee are a et ee mre ee me eee ee ee me ae ee ee as as eee ee ee ee ee a ae a a a a a a ee ee 


TYPE H SOFTWARE PRODUCT. } STD. | OPT. 


Program {| Task management i 
Develop- ; Job accounting H 
ment i Memory management H 
{ Timer management i 
{ File management H 
{ 1/0 management H 
i Error recording and reporting i 
{| Memory diagnostics H 
i Loader and segmentation i 
{ Console monitor i 
| Command processor i 
{| Floating point i 
i} Internal interrupt subsystem i 
i *Integrated Transaction Controller (ITC) H 
| Writable Control Store (WCS) H 
} Multi-Terminal Monitor (MTM) ! 
lero sceSeseies sae kee eee eeu eee tesa sete eee se Sasso Sa soe 
} Program i Automatic interactive debugging H 
i Debugging } system (AIDS) | 
i | DEBUG/32 i 
‘ 


ee ee ee 


{| Asynchronous data communications i 
Communi- | Character synchronous communications H 

| Bit synchronous communications { 

{| 2780/3780 RJE emulation H 

! 3270 emulation H 

| HASP/32 H 
Languages | Common Microcode Assembler (MICROCAL) { 
{| Common Assembly Language/32 (CAL/32) i 
| CAL Macro/32 H 
| FORTRAN VII Development (D) Compiler | 
| FORTRAN VII Global Optimizing (0) Compiler | 
| FORTRAN VII Universal Optimizing (2) i 
{ Compiler i 
{ *COBOL i 
{ BASIC Level II ; 
{| CORAL 66 ‘ 
i i 
i i 


ce covu sme ome memes mms meme memes sam SU SED GON SUS SN) ces mis ae ee ee ee ee eee ee ee a ee ee ee ee ee eee ee ee eee ee ee 


Utilities 


! i 
| } 
| Text { 
{| Source Updater { 
| Copy H 
| Library Loader | 
| Macro Library i 
{| Sort/Merge II 
' 

| i 
i H 
i i 
i | 


me OO 


Patch 

0S/32 Spooler 

SPL/32 

Fastchek 

Fastback 

Account Reporting Utility 


—m w me ee e e e e ee e ceee e e e e  e e e e  e eweeee eeee 
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mm KM OM 


* ITC, COBOL, and DMS/32 comprise the Perkin-Elmer Reliance software 
system designed for transaction processing. 
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1.2.1 Task Management Subsystem 


The task management subsystem allocates processor time for each 
of the tasks executing in an OS/32 multi-tasking environment. 
The task manager determines the order in which each task gains 
processor control on a user defined priority basis. Task 
priority levels range from 0 through 254 (0 being the highest 
priority level). Of these 255 priority levels, 10 through 249 
are available for user-written tasks, while 1 through 9 and 250 
through 254 are reserved for system use. 


The task manager maintains four priority levels for each task: 


e Maximum 
e Task 
e Run 


e Dispatch 


Maximum priority, set by Link, is the highest priority level 
(i.e., smallest number) that can be assigned to a task. Task 
priority is the priority that is currently assigned to a task. 
Initially, task priority is set when the task is linked, but this 
priority can be changed after the task is loaded. However, task 
priority can never be set higher than the maximum priority set by 
Link. 


Run priority may be set dynamically to a value ranging from the 
task priority to task priority plus n. The value of n is based 
on the behavior of the task. Run priority can only be set for 
tasks that have dynamic time-slice/priority scheduling enabled. 
If dynamic scheduling is not enabled, a task's run priority is 
equal to its task priority. Currently, only MT enables dynamic 
time-slice/priority scheduling. 


A dispatched task usually has a priority level equal to its task 
priority, even if dynamic scheduling is enabled. Nevertheless, 
if a higher priority task requires specific system resources 
(e.g., a disk directory or bit map) that are currently controlled 
by a lower priority task, the dispatch priority of this lower 
priority task is raised to the priority of the higher priority 
task waiting for the resource. When a task releases control of 
a system resource, its dispatch priority is reset to its run 
priority. 


Tasks competing for processor time are maintained in priority 
order on a etask control block (TCB) queue known as the ready 
queue. Tasks competing for both memory and processor time are 
maintained in priority order on the roll-in queue. Tasks at the 
same priority level are serviced on a round-robin basis; i.e., 
tasks are added to the ready queue or roll-in queue behind tasks 
of the same priority. 
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In the absence of time-slicing, once a task gains control of the 
processor, it continues executing until it voluntarily 
relinquishes that control or is preempted by a higher priority 
task. A task will relinquish control of the processor to another 
task when: 


e it is paused by the system operator; 


e it is cancelled by the system operator, user, or by another 
task; 


e a higher priority task becomes ready due to an external event, 
such as the completion of an outstanding I/O request; 


e it executes a supervisor call (SVC) that places it ina wait, 
paused, or dormant state; 


e it initiates I/0 to a device; or 


e its time-slice expires. 


After the task relinquishes control of the processor, it is 
returned to the ready queue where its TCB is placed behind the 
TCBs of tasks of equal priority. This allows the other tasks on 
the queue to be given a turn on the processor. 


To determine which task should have control of the processor, the 
task manager chooses the highest priority task among those on the 
ready queue, the roll-in queue, and any currently executing task. 
If a task is chosen from one of the queues, the currently 
executing task is placed back on the ready queue and the chosen 
task becomes the current task. 


The task manager supports two types of time-slicing: 


e System time-slice 

e Dynamic time-slice 

System time-slicing may be enabled by the operator to limit the 
execution of a task so that round-robin scheduling of priority 


tasks can take effect. Time-slicing allows tasks of equal 
priority to receive equal shares of processing time. 
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Dynamic time-slicing is enabled only for MTM_ subtasks. The 
dynamic time-slice is calculated as: 


slice = 1 + 2**m 


Where: 


m = task priority - run priority + l 


The units of slice are line frequency clock ticks (one clock tick 
= 8.333 milliseconds). 


Run priority is adjusted whenever a task uses up a time-slice or 
is removed from a wait state. When a task uses up a time-slice, 
its run priority is adjusted as follows: 


New run priority = run priority + 1 or 
task priority + k (whichever is smaller) 


Where: 


k = number of dynamically scheduled tasks or 12 
(whichever is smaller) 


Because a task that is placed in a wait state has not used up its 
last assigned time-slice, the run-priority of the task when it is 
removed from suspension is adjusted as follows: 


Run priority = run priority - 1 or 
task priority (whichever is larger) 


The task manager also performs intra-task context switches’ to 
allow tasks to receive and handle task traps in response to 


synchronous and asynchronous trap-causing events. Synchronous 
events include task-initiated faults (e.g., arithmetic, memory 
access, illegal instruction, etc.) and SVC 14 traps. 


Asynchronous events originate outside of a task and include the 
task queue traps (e.g., I1/0 and timer completion, SVC 6_ send 
message/data and queue parameter, etc.) and the task event traps 
currently associated only with SVC intercept support. 


In addition to task scheduling and task trap support, the task 
manager handles the state of a task during execution. Task 
execution state is determined by the setting of the program 
status word (PSW). The task manager switches or exits tasks from 
one execution state to another. 
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1.2.1.1 Task Scheduling on a Model 3200MPS System 


The OS/32 task manager uses four different types of queues’ to 
facilitate task scheduling on a Model 3200MPS System: 


e CPU ready queue 
e CPU receive queue 
@ APU ready queue (one per APU) 


e CPU roll-in queue 


When a task requests processor time on a Model 3200MPS System, 
the task manager adds the tTCB for that task to the CPU ready 
queue. The task manager selects a task for execution from the 
queue on ae strict priority basis. After selecting a task, the 
task manager then decides whether the task is to be executed on 
the CPU or on one of the APUs in the system. A task is 
transferred to an APU for processing only when all of the 
following conditions are true: 


e The task is being dispatched to the user execution state. (If 
the task is being dispatched to a system state, it will run on 
the CPU.) 


e The task is assigned to an LPU number greater than zero. 
(Each task running on the Model 3200MPS System is assigned an 
LPU number. An LPU number is mapped to an APU or the CPU; I.PU 
0 is always mapped to the CPU.) 


e The task status word (TSW) does not specify CPU-override 
status. (If the CPU-override status bit of the TSW is set, 
the task is executed on the CPU.) 


e The APU to which the LPU number is mapped is marked on. 


When all of the above conditions are true for the highest 
priority task on the CPU ready queue, the task manager transfers 
the TCB for that task from the CPU ready queue to an APU. If the 
APU is waiting for the task (i.e., APU processing has been 
suspended until the task arrives), the TCB becomes the current 
TCB and execution begins immediately. If the APU is not waiting 
for the task, the TCB is placed on the APU ready queue. 


Whenever it is not processing a task, the APU continually checks 


its APU ready queue. If the APU finds entries on the queue, it 
will execute the task at the top of the queue. 
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Once the APU starts a task, the task will continue to execute 
until it relinquishes control voluntarily (reschedules itself), 
encounters a fault, issues an SVC, or is returned to the CPU via 
an operating system request on behalf of a monitoring task, 
operator command, etc. The task may reschedule itself to the 
rear of the APU ready queue or to the CPU. In the latter case, 
and in the cases of a fault, or SVC or operating system request, 
the task is returned to the CPU receive queue. The task waits on 
the receive queue until the CPU places the task on the CPU ready 
queue. 


If the task is placed on the receive queue as a result of a 
fault, the task is moved to the CPU ready queue. If the 
appropriate bits in the TSW are set, the task's TSW location is 
set to the address of the task trap handler. The task can then 
be dispatched back to the APU ready queue. 


If the task is placed on the receive queue as a result of issuing 
an SVC, the task is moved to the CPU ready queue and executed on 
the CPU until SVC processing is complete. The task can then 
automatically move back to the APU ready queue. 


Rollable tasks are moved from the roll-in queue to the CPU ready 
queue and are processed in the same manner as any other task 
running on a Model 3200MPS System. Rollable tasks may be 
dispatched to an APU. However, while a task is executing on an 
APU (or queued for execution to an APU) the task is considered 
nonrollable by the system. 


1.2.2 Job Accounting Subsystem 


The job accounting subsystem reports CPU usage and time elapsed, 
memory and disk space utilized, and number and length of I/0 
transfers by device class. The job accounting subsystem contains 
the: 


@e Data collection facility 

e Account reporting utility 

The data collection facility collects accounting data on all user 
activities and stores this information in the accounting 


transaction file (ATF) when the task terminates. The account 
reporting utility is designed to accommodate specific customer 


site requirements. The performance data collected by the data 
collection facility is prepared by the account reporting utility 
for use by system maintenance personnel. Reports can be 


requested for individual user accounts, summaries of user 
accounts, and system usage. See the 0OS/32 System Support 
Utilities Reference Manual. 
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Through the DISPTAY ACCOUNTING command, the system operator has 
access to accounting data for one or all tasks in the system. 


NOTE 
The OS/32 job accounting subsystem does 
not report APU usage and time elapsed in 
a Model 3200MPS System. 
1.2.3 Memory Management Subsystem 
When a task is loaded, the memory management subsystem 


Gynamically allocates necessary space in memory. 0OS/32 supports 
three types of memory: 


e Local 
e Shared 
e system 


Local memory is physically contiguous starting from location O0O 
and contains the operating system, task space, and system space. 


Shared memory is located above local memory and is not required 
to be contiguous. Global task common segments located in shared 
memory can be used by more than one processor. 


System memory is that which is shared by all processors in a 
Model 3200MPS System. System memory contains both local and 
shared areas. Local memory is used by the CPU and all APUs. 


Local memory is allocated on a first fit basis when sufficient 
memory is available for a specific task. Free segments are 
allocated in ascending address order. When no space is available 
for a task, the memory manager determines which tasks are to be 
rolled out to ensure that higher priority tasks take precedence. 
When memory becomes free, adjacent areas are merged together to 
minimize search time and to provide large free blocks of memory 
for bigger tasks. System task space is also maintained by the 
memory manager and is dynamically allocated when a task or device 
structure is built. 


The memory manager maintains task space through free and 


allocated lists. Segments are allocated dynamically on a first 
fit basis by searching the free lists. When free task space is 
allocated to a segment, it is removed from the free list and 


connected to the allocated list. This list is called the segment 
control list (SCL). Similarly, whenever a segment is’ released, 
its memory space is removed from the allocated list and connected 
to (or merged into) the free list. 
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1.2.4 Timer Management Subsystem 


The timer management subsystem provides tasks with a set of timer 


management/maintenance services. 


dependent functions (e.g., time-slicing, 


These services control all time 
I/O, job accounting, and 


file dating) through the universal clock. 


The following timer queues are maintained by the timer management 


subsystem: 


e Time of day 
e Device timeout 
e Communications device timeout 


e Interval timer 


There are several timer routines that service these queues. 
Entries are placed on the time of day queue and the interval 
timer queue as a result of supervisor call 2 (SVC 2) timer 
requests. The control blocks on the time of day queue are 


referred to as timer queue elements (TMQs). 
format as 


queue has the same 
maintained as a separate queue. 


The universal clock consists of a line frequency clock (LFC) 


a precision interval clock 
generates an interrupt every 8.3 
second. In a 50Hz system, the 
10 milliseconds or 100 times per 
a task's requested time interval 
4,096 milliseconds, whichever 

terminates or the time of day is 


system space and a trap is generated, 


timer wait. 


In a Model 3200MPS System configuration, 


module (RTSM) 
counter for 
incremented 

oscillator. 

counters. 


provides 
timing program 
every 
The RRTC 


The interval timer 


the time of day queue but is 


and 
(PIC). In a 60HZ system, the LFC 
milliseconds, or 120 times. per 


LFC generates an interrupt every 


second. The PIC interrupts when 
has expired or at intervals of 
is shorter. If the interval 


reached, the TMQ is removed from 
or the task is removed from 


the real-time support 


each processor with a 32-bit real-time 
execution. 
microsecond 
instruction 
See the Perkin-Elmer Model 3200MPS System Instruction 


These counters 
RTSM 1MHz 
tasks to 


are 
on-board 
read the 


by an 
allows 


Set Reference Manual for more information. 
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1.2.5 File Management Subsystem 


The OS/32 file management subsystem stores and retrieves 
information for a task on secondary storage devices (disks, 
floppy disks, etc.). The file manager partitions this storage 
into smaller areas, called files, that can be used by tasks for 
data and program storage. In addition, the file manager provides 
tasks with the following support services for file management: 


Allocate creates a file by allocating space on a 
secondary storage device. 


Delete removes a file from a_ secondary storage 
device. 

Rename changes the name of a file. 

Open assigns an lu to a file. 

Close cancels the lu assignment. 

Fetch examines the attributes of a file. 

attributes 

Checkpoint ensures that all data in an output buffer is 


written to a secondary storage device. 


Software selects recording density for 6250 bpi 
density magnetic tape drives. 
selection 


1.2.6 Input/Output (1/0) Subsystem 


The 1/0 subsystem provides a uniform programming interface 
between the task and external devices. I/0 operations can occur 
in the following task modes: 


Wait halts execution until data transfer is 
completed. 

Proceed I/0 continues task execution during data transfer. 

Halt 1/0 allows the task to cancel previous proceed 1/0 
requests. 

Queued I/O allows a task to queue I/O requests to a busy 
device and continue execution until the device 
is free. 


A task trap mechanism can be used to report each completed I1/0 
operation. Wait-only and test I/O functions allow the task to 
synchronize its execution with the completed 1/0 operations. 
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1.2.7 Error Recording Subsystem 


The error recording subsystem logs all data on disk errors’ for 
the error reporting utility, which analyzes the data and 
generates reports. 


OS/32 memory error recording software supports the memory error 
log hardware of the Perkin-Elmer Series 3200 machines. Error log 
hardware keeps a history of the single bit corrected memory 
errors. The operating system reads the error log hardware and 
stores the error information into an internal error log buffer. 
When the error log buffer is full, its contents are stored on an 
error recording file with the date and time of the last error 
recorded. When the error recording file is almost full, a 
warning message is displayed on the system console indicating 
that a new error recording file should be allocated or that’ the 
error reporting utility should be initiated. The error reporting 
utility provides reports on the previously recorded error 
information in the error recording file. 


The current error status can be displayed to the system console 
by using the DISPLAY ERRORS command. The internal error log 
readout period can be changed by the system operator. 


1.2.8 Memory Diagnostics Subsystem 


The memory diagnostics subsystem eliminates inoperable memory 
areas from the system without affecting task execution. It 
allows the operating system to execute when portions of real 
memory have been removed (holes) or when a part of the system is 
powered down for maintenance. Memory can be tested, marked on, 
and marked off through the operator MEMORY command or when the 
operating system is initialized. 


The marked off areas are noted as allocated in the memory map. 
Memory is marked on when previously marked off memory is to be 
used again. If an unrecoverable memory error occurs during task 
execution on a Perkin-Elmer Series 3200 processor, the operating 
system automatically marks off the area occupied by the task. 


1.2.9 Loader and Segmentation Subsystem 


The OS/32 resident loader is responsible for loading tasks, 
reentrant libraries, task common (TCOM) segments, and partial 
images. These tasks and segments must have been built by Link. 
Each task image generated by Link contains information related to 
the task (e.g., task options, size, libraries referenced) ina 
record called the loader information block (LIB). 


The O0OS/32 resident loader uses this information to generate data 


areas, set the task options, create segment tables for the tasks, 
and map the task segments. 
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All user tasks (u-tasks) in OS/32 are built as though they were 
loaded at physical address 0 in memory. The 
relocation/protection hardware automatically relocates the task 
addresses at run-time by using the task segment table. This 
process is totally transparent to the user. 


The loader is also responsible for creating the task environment; 
allocating roll files; creating, maintaining, and deleting 
segment tables; maintaining a segment control list; and mapping 
and unmapping partial images. 


The task image can be divided into pure and impure segments’ by 
specifying the SEGMENTED task option when the task is built by 
Link. Regardless of the number of times a task is loaded, the 
loader will allow only one copy of the task's pure segment in 
memory at any one time. A separate copy of the task‘'s'= impure 
segment is loaded each time the task is loaded. The 
relocation/protection hardware ensures the integrity of pure 
segments by allowing only read and execute only access privileges 
to those segments. 


Access to task common is achieved mnemonically in FORTRAN or 
assembly programs. The linkages are resolved by Link. Link 
commands are also used to request read, write, and execute 
privileges for task common blocks. See the OS/32 Link Reference 
Manual for more information. 


1.2.10 Basic Data Communications Subsystem 


The basic data communications subsystem provides a software 
interface between tasks and common carrier facilities. Basic 
data communications facilities allow the user to access’ remote 
terminals or computers as though they were locally attached 
peripherals. For example, with 0OS/32 Data Communications 
software, a task performs I/O to a remote terminal in the same 
manner as I/O to a local device. 


In addition to providing device independent (logical 1/0) access 
to the task, the subsystem provides a device dependent 1/0 
capability that allows the systems programmer to tailor a 
communications package to a particular installation. Such a 
package can include device dependent and device independent 
support of asynchronous line devices as well as device dependent 
support of binary synchronous lines. 


The OS/32 Basic Data Communications software support package is 
required for all 32-bit communications products; e.g., HASP, 
2780/3780 Remote Job Entry, and the ZDLC Channel Terminal 
Manager, which supports the SDLC, HDLC, and ADCCP protocols. 
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1.2.11 Console Monitor Subsystem 


The console monitor subsystem processes all I/O requests directed 
to the system console device and the system log device from all 
tasks including the command processor task. The console driver 
is responsible for intercepting system console I/O requests” and 
for directing them to the console monitor or to another monitor 
task such as MT. All I/0 operations between the system console 
and tasks running under MT are routed to the user's terminal 
through MTM and not through the console monitor. 


When a command is issued from the system console, the console 
monitor issues an SVC 6 to the command processor notifying it of 
a command to be processed. The command processor interprets’ the 
command and issues an SVC 6 to the console monitor indicating 
that it is ready to accept another command. 


The console driver is a part of the OS/32 I/O subsystem and is 
the module that intercepts I/O requests to the system console, 
processes them, and gives them to MTM or to the console monitor 
to do the actual I/0. 


The console monitor is the first task dispatched at 08/32 
initialization. The console monitor initializes both itself and 
the dummy device control block (DCB) used by the console driver 
to intercept requests from the system console. The monitor then 
issues an SVC 6 to start the command processor. 


1.2.12 Command Processor Subsystem 


The command processor subsystem accepts commands from the’ system 
console monitor, decodes them, and calls the appropriate 
executor. Commands can be input to the command processor by 
entering them directly through the system console or issuing them 
through a foreground task which uses the system console as an 
interactive I/O device. Commands input from a foreground task 
are executed by the command processor in the same manner as 
commands entered from the system console. If an error occurs 
during execution of a command, the command processor outputs an 
error message to the console. 


An extension to the command processor, the command substitution 
system (CSS) allows commonly performed sequences of operations to 
be executed with one command. The CSS routines provide the user 
with the ability to build, execute, and control files of operator 
and MTM commands. The user establishes command files that are 
called from the user console and executed in the user defined 
sequence. In this way, complex operations can be carried out by 
the user with few commands. These commands are analogous to 
macro instructions in assembly language. 


48-040 FOO RO2 L155 


The command substitution system (CSS) provides a set of logical 
CSS commands to conditionally control the precise sequence of 
commands to be executed. Parameters can be passed as part of a 
CSS call so that general sequences can be written that take on 
specific meaning only when the parameters are substituted. Other 
calls to CSS files can be imbedded within a CSS file (nested 
calls). 


The command processor normally runs at the second highest 
priority level after the console monitor in OS/32. This task is 
strictly trap driven and responds to the SVC 6 task queue 
parameter calls from the console monitor to service a command 
request. When the command is processed, it signals the console 
monitor for a new command read via an SVC 6 queue parameter call 
and then enters into a trap wait state. The command processor 
priority can be decreased by the operator ATTN command. This 
command can be used in a real-time application environment’ to 
allow a task to run at a higher priority than the command 
processor. 

1.2.13 System Initialization Subsystem 

After the operating system is loaded, the system initialization 
subsystem initializes the memory diagnostics subsystem, error 
recording subsystems, and system control blocks and tables in 
memory. It then dispatches the console monitor which readies the 
command processor to accept commands from the system console. 
1.2.14 Internal Interrupt Subsystem 


The internal interrupt subsystem is responsible for: 


@e handling illegal instruction faults, 

e handling arithmetic faults, 

@ detecting memory faults, 

@e handling system queue service interrupts, 

e handling relocation/protection hardware faults, 

@e handling data format/alignment faults, 

@e handling power fail and power restore conditions, 


e restoring an interrupted task to its previous program state 
upon resumption of the task, 


e@e handling parameter block errors, 
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e handling illegal SVCs and SVC interrupts, 
@e handling machine malfunction interrupts, and 


e performing memory image dumps. 


Processor dependent interrupt handlers comprise the internal 
interrupt subsystem. The internal interrupt subsystem does not 
support external I/O interrupts. External interrupts are handled 
by the appropriate device drivers. 


On a Model 3200MPS System, the CPU handles all fault conditions 
or interrupts that occur during execution of a task on an APU. 
Thus, the APU can execute another task while the CPU is handling 
the fault or interrupt. 


1.2.15 Optional User Supervisor Call (SVC) Subsystem 


Svc 14 is provided as an optional SVC that can be defined by the 
user. On execution, the task receives a task trap for SVC 14. 
See the 0S/32 Application Level Programmer Reference Manual for 
information on how to implement the SVC 14 trap feature. 


1.2.16 Floating Point Subsystem 


A task has optional access to single and/or double precision 
floating point instructions under OS/32. Floating point 
instructions can be executed through hardware or simulated by 
software. Those systems that do not’ support floating point 
options handle all floating point instructions as illegal 
instructions. 
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CHAPTER 2 
PRIVILEGED TASKS 


2.1 INTRODUCTION 


In a multi-user system, improper use of certain machine 
instructions, called privileged instructions, can have a 
detrimental effect on system integrity. Privileged instructions 
include storage protection setting, interrupt handling, timer 
control, input/output (1/0), and some processor status-setting 
instructions. To prevent accidental or intentional misuse of 
these instructions, OS/32 provides a privileged operating state 
in which tasks can execute these instructions. In addition to 
the privileged operating state, OS/32 also provides a privileged 
task state in which tasks can access the file account and bare 
disk OS/32 supervisor routines. 


Only privileged tasks can execute ina privileged operating or 
task state. OS/32 allows three types of privileged tasks: 

@ executive tasks (e-tasks), 

@® privileged user tasks (u-tasks), and 

@ diagnostic tasks (d-tasks). 


A task can be linked as a privileged task by specifying one or 
more of the following task options in the Link OPTION command: 


ETASK, ACPRIVILEGE, DISC, DTASK 
See the OS/32 Link Reference Manual. 


This chapter describes the privileges that are available to each 
type of privileged task through the Link OPTION command. 
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2.2 EXECUTIVE TASKS (E-TASKS) 


E-tasks run with the memory address relocation/protection 
hardware turned off and are allowed to execute all instructions 
provided by the hardware. E-tasks always have file account and 
bare disk privileges. In addition, e-tasks can execute code that 
modifies or enhances the OS/32 system software. For example, an 
e-task can modify one of the system modules to enhance an 
existing OS/32 feature. E-tasks can also function as drivers 
that support nonstandard peripheral devices. A task can _ be 
linked as an e-task by specifying the ETASK task option in the 
Link OPTION command. 


The following sections detail the programming considerations that 
must be taken into account when writing e-tasks. 


2.2.1 Writing Executive Tasks (E-Tasks) 


Because e-tasks execute in a privileged state, certain 
precautions must be taken when e-tasks are programmed. 


When an e-task is executing, no memory address’ protection or 
relocation is provided and all interrupts are enabled. The task 
has access to all machine instructions and memory address’ space 
in the system. In addition, the e-task can access system tables 
and control information via the system pointer table (SPT). The 
address of the SPT is stored in the halfword at location X‘'62’ in 
memory . 


Link builds the image for an e-task as if it were loaded at 
absolute location zero. The loader, however, is free to load the 
e-task into any available memory location. Therefore, an e-task 
must be coded as if it were positionally independent; an e-task 
must not contain relocatable code. 


Because Link relocates e-task addresses to absolute zero, e-tasks 
cannot assemble code containing address constants as shown in the 
following example. 


Example: 


SVC7BI.K DB X'80°,7 
DAC ADDR 


An e-task must dynamically set the addresses required by the 
task. 
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To reference addresses in the +16kb range, use the following 
technique: . 


LA UE, BUFSTART 
LA UF , BUFEND 
LA U3 ,SVC1PBK 
STM 


UE,SVC1.SAD(U3) 
SVC 1,0(U3) 


References to addresses exceeding the 16kb range can be made _ in 
the following manner. 


Example: 


BASE LA U4, BASE 
LA UE , BUFSTART-BASE (U4) 
LA UF , BUFEND-BASE (U4) 
LA U3, SVC1BLK-BASE(U4) 
STM  UE,SVC1.SAD(U3) 
svc 1, 0(U3) 


E-tasks smaller than 16kb must use the no RX3 £(NORX3) £(CAL/32) 
instruction to force all RX instructions to the RX1 or RX2 
format. The tasks must not contain any RX1l or RX3_ instructions 
with relocatable addresses. See the Common Assembly Language/32 
(CAL/32) Programming Reference Manual. 


2.2.2 OS/32 Data Structures Used by Executive Tasks (E-Tasks) 


OS/32 provides a data structure macro library that contains macro 
routines for building OS/32 data structures in the e-task address 
space. Field names for the data structures are also. included. 
The OS/32 data structure macro library is stored in file 
SYSSTRUC.MLB. Table 2-1 lists the 0OS/32 data structures 
available to e-tasks and their corresponding macros. 


Using the 0OS/32 e-task capability and the data structures 
available to e-tasks, the system level programmer can incorporate 
changes or add user written modules to the source of the 0S/32 
system modules supplied by Perkin-Elmer. 
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TABLE 2-1 OS/32 DATA STRUCTURES USED BY E-TASKS 


Ne ee A ee ed ee ed nd 


MACRO i DATA STRUCTURE 


$ACB Directory access control block 


$AOPT APU options 
$APB Auxiliary processor block 
$APBS $APB,$APRC,$APS, $AOPT 
$APRC Passback reason codes and equates 
$APS APB status codes and equates 
$APST APU status codes and error codes and equates 
$ATF Accounting transaction file 
$AUF MTM authorized user file 
$CCB Channel control block (CCB) 
$CTX User task context block 
$DATB Device attributes equates 
$DCBS$ $PDCB,$DDCB,DCB EQUATE, $DFLAG, $DATB, $DXFL 
$DDCB Device dependent device control block (DCB) 
$DDE Error log data structure 
$DFLG DCB flags 
$DIR$§$ Primary directory entry 
$DXFL Disk extended flags 
$EMIL System milestone recording entries 
Bulk device error recording entries 


i 
| 
i $EFMG 
| 
| 


H 
H 
H 
| 
i 
i 
i 
1 
i 
i 
$EREGS | 16 executive registers (El=register 1) 
i] 
! 
H 
H 
H 
i 
| 
i 
i 
i 
H 


a ee eee een eee ee ee ee ew we ee ee ee ee eee ee ee ee ee ee ee ee ee ee ee eee ee we ee we we we ee we wwe ew we we we we oe 


$ERRCS$ $GERC, $EFMG, $ESYS, $EMIL, $MERC 
$ESYS System error recording entries 
$EVN Event node 

$FCB File control block (FCB) 

$FCB$ FCB and FCB flags 

$FDE Free block descriptor entry 
$FFLG$ FCB flags 

$FD File descriptor (fd) 

$GERC General error recording information 
$HB Help subroutine argument block 
INTCPARM SVC intercept information 

$ICB Intercept control block 

$10OB I/O block 

$IOB$ I/O and I/O flags 

$ IOBF I/O block flags 

$IOH I/O handler list 

$IPCB Intercept path control block 
$IRCB interceptcontrol block 

$IVT Initial value table 
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TABLE 2-1 OS/32 DATA STRUCTURES USED BY E-TASKS (Continued) 


I a I Be ee el 


| MACRO DATA STRUCTURE 

| Serer eS Ss SS SSeS SS SSS SSS SS SS SS A SLSEL EFCC LSS KK Seer rSr reese Sse 
| $LIB | Loader information block (LIB) 

| $LIB$ | LIB and loader options 

| $LPMT | Logical processor mapping table 

| $LOPT | Loader options 

| $LSG | Load segment 

i $LTCB {| Loader task control block (TCB) redefinitions 
| ; 

i $MAGDCB | Magnetic tape DCB 

| $MERC | Memory error recording entry 

i $MTMSTE | MTM terminal and task status and modes 

4 ! 

{ t 

i $OCB | Overlay control block 

i $ODT | Overlay descriptor table structure 

| $ORT | Overlay reference 

' { 

! | 

i $PDCB | Primary (device independent) DCB 

| $PFCB | Private FCB 

| $PSDCB | Pseudo DCB structure (device dependent) 

| $PSTCB | Pseudo task control block 

i} $PSW | Program status word (PSW) 

+ $QH ; SVC intercept queue handler structure 

i $RCTX i RS/RSA context block 

| $REGS§$ | $SOPT, $UREGS, $EREGS, $RREGS, $PSW 

| $RLST { Roll selection list | 

| $RREGS | 16 general user registers (Rl = register 1) 
| $RSARCPY | Reentrant system state alternate save area 
! | 

f ' 

| $S1X0 ; svc l 

| $SDCB {| Pseudo print device control block structure 
i $SD | Send data message block 

i $SDE | Segment descriptor element 

| $SOPT | System options 

| $SPCMSG | Spooler message structures 

i $SPT | System pointer table (SPT) 

| $SPTE | SPT extern definitions 

t $SPOL | Spooler message 

| $STE | Segment table entries 

| $SPR | Segment privilege flags 
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TABLE 2-1 0OS/32 DATA STRUCTURES USED BY E-TASKS (Continued) 


MACRO DATA STRUCTURE 


ss Sr er Ser EF EF EK EBEKEKKSEOSCCS EK ESSE SESS SESS SS SSE STESECKEKLESK ESBS SESS STs SS 


i 
{ $SVC1 i Supervisor call 1 (SVC 1) H 
| $SVC1$ {| SVC 1 and SVC 1 error codes H 
{ $SVCLERR {| SVC 1 error codes H 
| $SVC4 i System SVC - reserved H 
| $SVC5 | SVC 5 parameter block H 
| $SVC6 | SVC 6 parameter block { 
| $SVC7 | SVC 7 parameter block { 
| $SVC7SPL {| Spooler SVC 7 parameter block H 
i $SVC13 | SVC 13 parameter block | 
| $SVC13$ | $SVC13,$APST 
| $SYP i System space structure H 
| $$SPT | SPT table definitions i 
1 S 4 
t t { 
| $TABLS ; Structure/extern generating macro H 
| $TCB | Task control block, $SDE,$10B$,$TCB,$CTX i 
i $TCB$ {| $TCB,$TOPT,$TSTT,$TWT,$TLFL,$PSTCB,$0CB,$TQE, | 
H | $TFL,$TPRC,TQH { 
{ $TERMUSR$ | MTM terminal user block H 
| $TKQ i Task queue head | 
|} $TLF | Task control block flags H 
| $TLFL | Logical unit table of flags H 
i $TMQ } Timer queue entry (TQE) H 
| $TOPT i Task options flags i 
| $TPRC i Task passback codes 
| $TQE i Task event queue entry 
i $TQ27 i SVC 2, code 27 parameter block H 
| $TQH | Task event queue header H 
i $TSTT i Internal task status flags H 
i $TSW i Task status word (TSW) H 
{| $TTB | APU trap block 
| $TWT | Task wait status flags 
] 1 ’ 
( { ( 
| $UDL i User dedicated locations (UDL) | 
{| $UDL$ i; UDL and TSW 
| $UREGS i 16 general user registers (Ul = register 1) H 
! t 1 
{ | i 
} $VD | Volume descriptor H 
| $VFCHARS {| Vertical forms characters H 
| $VFDCB | Common VFC DCB structure { 
| $WAP | Read/write access matrix header structure { 
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2.3 PRIVILEGED USER TASKS (U-TASKS) 


Like nonprivileged u-tasks, privileged u-tasks run with the 
memory address relocation/protection hardware enabled and are 
restricted to a subset of instructions known as nonprivileged 
instructions. If a u-task attempts to execute a privileged 
instruction, it causes an illegal instruction fault. However, 
unlike nonprivileged u-tasks, privileged u-tasks have _ file 
account and bare disk privileges. File account privileges allow 
tasks to specify an account number in the file account/class 
field of a file descriptor. Bare disk privileges allow tasks to 
perform 1/0 operations to a bare disk device. See Chapter 3. 


A u-task acquires file account and bare disk privileges’ by 
specifying the ACPRIVILEGE and DISC task options, respectively, 
in the Link OPTION command when the task is built. 


2.4 DIAGNOSTIC TASKS (D-TASKS) 


D-tasks, like e-tasks, can execute all instructions provided by 
the hardware. However, like u-tasks, d-tasks run with the memory 
address relocation/protection hardware enabled and execute in the 
nonprivileged task state. D-tasks are designed for use in 
Giagnostic applications, loading WCS, and direct execution of 1/0 
instructions. 


A task can be linked as a d-task by specifying the DTASK task 
option in the Link OPTION command. To execute in the privileged 
task state, a d-task must be built with the ACPRIVILEGE and DISC 
task options enabled. 
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CHAPTER 3 
0S/32 SUPERVISOR CALLS (SVCs) 
FOR SYSTEM LEVEL PROGRAMMING 


3.1 INTRODUCTION 


OS/32 provides a number of system services for designing system 
level control programs. Access to these services is restricted 
to privileged tasks and/or by certain hardware requirements. 
Table 3-1 lists the 0OS/32 SVCs that access these system level 
services and the restrictions for their use. The following 
sections describe each system level SVC in detail. 


TABLE 3-1 OS/32 SVCs FOR SYSTEM LEVEL PROGRAMMING 


svc i RESTRICTED TO 
SVC 0: User written SVC Modification of OS/32 re- 
quired 


SVC 2 code 0: Make 
journal entries 


Executive tasks (e-tasks) 
only 


SVC 2 code 14: Internal 
reader 


Foreground tasks loaded 
from system console 


SVC 2 code 26: Fetch 
device name 


E-tasks only 


SVC 2 code 27: Memory 
management 


Tasks running on memory 
address translator (MAT) 
machines only 


SvC 6: System task 
release 


System tasks (.CMDP, .CSL, 
-MTM, and .SPL) 

SVC 7: Extended close E-tasks or privileged user 
tasks (u-tasks) and privi- 
leged diagnostic tasks 
(d-tasks) with bare disk 
(DISC) task option enabled 
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TABLE 3-1 OS/32 SVCs FOR SYSTEM LEVEL PROGRAMMING 
(Cont inued ) 


SVC i RESTRICTED TO | 
SVC 7: Fetch attributes E-tasks or privileged 
for bare disk devices u-tasks and privileged 
d-tasks with the bare disk 
(DISC) task option enabled 


SVC 7: Device rename and 
reprotect 


E-tasks only 


SVC 7: Bare disk assign- 
ment 


{ 
| 
| 
| E-tasks or privileged | 
| u-tasks and privileged { 
|} d-tasks with bare disk H 
i (DISC) task option { 
i enabled. H 
i 
SVC 13 code O and code l {| No restrictions. H 
{| Available to all tasks H 
{ running on the Model 
{| 3200MPS System. 1 
| 
| 
| 
i 
| | 


SVC 13 code 2 and code 3: 
Auxiliary processing 
unit (APU) control 


Tasks running on the Model 
3200MPS System that have 
APU control (APCONTROL) 

and APU mapping (APMAPPING) 
task options enabled. 
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3.2 SVC 0: USER WRITTEN SUPERVISOR CALL (SVC) 


SVC 0 is reserved for user written OS/32 executor routines. 
Before writing an executor routine that can be called by SVC 0, 
the operating system must be modified. This modification can be 
done dynamically at run-time by an e-task. Note, however, that 
the SVC executor table contains only halfword entries; therefore, 
the first instruction of the executor routine called by SVC 0 
must lie within the first 64kb of physical memory. 
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3.3 SVC 2 CODE 0: MAKE JOURNAL ENTRIES 


SVC 2 code 0 makes an entry into the system journal from an 
e-task. The system journal provides a method to trace back 
important events (SVCs, input/output (I/0) operations, task 
switching) that occurred during system operation. For example, 
the journal is useful for tracing the cause of a system failure. 
The parameter block format for SVC 2 code O is shown in Figure 
S=1: 


10(0) 12(2) 
Code i Journal code 
{ { 
ee ee eee ! 
14(4) 
Value l 
a aera a RS le a a a a 
18(8) 
Value 2 
ect snake cas std: “e- “eg “WMS eect Sed Sasa. Ses ice‘ sesh “Sem oul vale Qassim i: sku em “sl: Sle wa els, seit ak gg “Ta iti sag ss: als wa ada { 
J 4 
112(C) 
Value 3 
ey ss as cacti ames wale amis Geb sms ss” ccm aes” ms" em newest oc cms asa “mem ems tes "ces cm ms tua ss "ens eee Sel Fac es ene ha { 
116(10) 
Value 4 
| 1 
{ j 


ee a Ce ee OE ee Ye Ge a ae ee ee ee Oe et ee eee a ee Oe ee ee cee cee ee eee 


svc 2,parblk 


parblk DC H'O! 
DC H'journal code' 
DC F'value lL' 
DC F'value 2' 
DC F'value 3' 
DC F'value 4' 


Figure 3-1 SVC 2 Code O Parameter Block Format and Coding 
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During execution, a logical OR operation is performed on a mask 
and the journal code to indicate that the entry originates from 
an SVC 2 code O, rather than from within the system. The value 
1, 2, 3, and 4 fields of the parameter block are stored following 
the journal code and calling task name in the journal. These 
values can contain any desired information to be preserved for 
system debugging. 


NOTE 
This call has an effect only if the 


journal is included in the system at 
(source) system generation (sysgen). 
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i SVC 2 


3.4 SVC 2 CODE 14: INTERNAL READER 


SVC 2 code 14 allows a foreground task loaded from the system 
console to invoke operator and command substitution system (CSS) 
commands. These commands are sent to the command processor where 
they are executed as if they were entered from the system 
console. SVC 2 code 14 provides two options for sending commands 
to the command processor. Option O allows the user to place the 
commands directly in the task command buffer field of the SVC 2 
code 14 parameter block. Option 1 allows the user to store the 
commands in a task command buffer located on a fullword boundary 
within the task's address space. The address of this buffer is 
placed in the parameter block. 


SVC 2 code 14 will transfer the commands in a task command buffer 
until the end of the buffer is reached. The parameter blocks for 


both SVC 2 code 14 options are described in the following 
sections. 


3.4.1 Parameter Block for Option 0 


The parameter block format for option O of SVC 2 code 14 is shown 
in Figure 3-2. 
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10(0) }1(1) {2(2) 
| Option H Code | Status H 
| | | 
a al i aaa wig ae GER ora aE 
14(4) {6(6) Maximum system H 
| User command i command buffer { 
| buffer length | length H 
lorie sank grace os Resign ik SE me Gee ee aa a eee ioe | 
18(8) | 
i H 
| | 
pe | 
112(C) 
Task 
H command | 
LaesSs buffer 9000 re 
116(10) 
! | 
a ES 
H 

SVC 2,parblk 

parblk DB 0,14,0,0 

DC H'user command buffer length' 

DC H‘O' 

DC ‘operator commands‘ 


Figure 3-2 SVC 2 Code 14 Parameter Block Format and Coding 


for Option 0 


This parameter block can be 


boundary aligned, 


and located in a task writable 


up to 1,032 bytes long, fullword 
segment. A 


general description of each field in the parameter block follows. 
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Fields: 


Option 


Code 


Status 


User 
command 


buffer 
length 


Max imum 
system 
command 
buffer 
length 


Task 
command 
buffer 


is a l-byte field that contains a value of 0 
to indicate that the task command buffer is 
contained in the SVC 2 code 14 parameter 
block. 


is a l-byte field that contains the decimal 
value 14 to indicate code 14 of SVC 2. 


is a 2-byte field that receives a status code 
indicating the status of the SVC processing. 
See 


is a 2-byte field specifying a decimal number 
indicating the maximum length allowed for the 
user command buffer. 


is a 2-byte field to which the operating 
system returns the system command buffer 
length established by CMDLEN at sysgen. This 
value is returned only for status code 
X'0003'. See Table 3-2. 


is avariable length field with a maximum 
length of 1,024 bytes. This field contains 
the commands to be sent to the command 
processor. | 


3.4.2 Parameter Block for Option 1 


The parameter block format for option 1 of SVC 2 code 14 is shown 


in Figure 3-3. 
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10(0) }1(1) 12(2) | 
Option Code Status 
| | 
a aa a a a aaa eee ata scan aia 
14(4) 16(6) Maximum system H 
User command H command buffer 
H buffer length H length H 
[Ser sae See te So eS 2 ae Sek eee Se Sea ee a aaa aoe aa 
18(8) 
| Buffer address 

SVC 2,parblk 

parblk DB 1,14,0,0 

DC H'user command buffer length' 

DC H'OQ' 

DAC BUFADR 


Figure 3-3 SVC 2 Code 14 Parameter Block Format and Coding 
for Option 1 


This parameter block is 12 bytes long, fullword boundary aligned, 
and located in a task writable segment. A general description of 
each field in the parameter block follows. 


Fields: 


Option 


Code 
Status 
User 
command 


buffer 
length 
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is a l-byte field that contains a value of 1 
to indicate that the parameter block contains 
the address of the task command buffer. 


is a l-byte field that contains the decimal 
value 14 to indicate code 14 of SVC 2. 


is a 2-byte field that receives a status code 
indicating the status of the SVC processing. 
See Table 3-2 for a list of the SVC 2 code 14 
status codes. 


is a 2-byte field specifying a decimal number 
indicating the maximum length allowed for the 
task command buffer. 


Maximum is a 2-byte field to which the operating 


system system returns the system command buffer 
command length established by CMDLEN at sysgen. This 
buffer value is returned only for status code 


X¥'0003'. See Table 3-2. 
Buffer is a 4-byte field specifying the address of 
address the task command buffer. This buffer must 


be located on a fullword boundary within the 
task's address space. 


3.4.3 SVC 2 Code 14 Status Codes 


The status codes for each of the SVC 2 code 14 options are listed 
in Table 3-2. 


TABLE 3-2 SVC 2 CODE 14 STATUS CODES 


Ce eh ee ede ee es ee es ee ee ee) 


| CODE MEAN ING 
x'OO00' Successful completion - commands sent to 


command processor for execution. 


xX'OOO1' No free internal reader buffers available. 


X'0002' Option error - invalid option specified 


for SVC. 


incorrectly. 


The length of the maximum allowed system 
command buffer is returned to the maximum 
system command length field. 


No internal reader command buffers 
def ined. 


X'FFFF' 


X'0003° {| User specified length of command buffer 
| 
i 


3.4.4 Programming Considerations 


Support for the internal reader must be included in the system at 
sysgen. This is accomplished through the SYSGEN/32 command, 
IREADER. See the OS/32 System Generation (SYSGEN/32) Manual. If 
the internal reader is not included at sysgen, an attempt to 
execute an SVC 2 code 14 results in an execution error and an 
illegal SVC message is sent to the user console. 
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The internal reader requires a set of buffers to receive the 
commands sent to it by SVC 2 code 14. The OS/32 operator 
command, I[RBUFFER, is used to create command buffers for the 
internal reader. See the OS/32 Operator Reference Manual. The 
IRBUFFER command can also be used to increase the number of 
command buffers when no free buffers are available (status code 
X'O0001'). IRBUFFER can be used at any time if support for the 
internal reader has been generated into the system. 


The following program demonstrates the use of SVC 2 code 14. 


Sample SVC 2 code 14 program: 


SVC214 PROG SVC 2,14 EXAMPLE 


svc 2, COMMANDO SEND COMMAND 


LH 0, COMMANDO +2 WAS IT SUCCESSFUL? 
BNZ STOP NO - ERROR 
svc 2, COMMAND 1 SEND COMMAND 
LH 0, COMMAND 1+2 WAS IT SUCCESSFUL? 
BNZ STOP NO - ERROR 
svc 3,0 EOT 
STOP EQU ” 
svc 2, PAUSE PAUSE 
svc 3,0 EOT 
ALIGN 4 


PAUSE DB 0,1,0,0 


ALIGN 4 

COMMANDO DB 0,14,0,0 DIRECT COMMAND BUFFER 
DC Z(4) 
DCX 0 


ALIGN 4 
COMMAND1 DB 1,14,0,0 INDIRECT COMMAND BUFFER ADDRESS 
DC Z (CMDBUF FE-CMDBUFF ) 
DCX 0 
DC A(CMDBUFF ) 
ALIGN 4 
CMDBUFF DC C'$WR ** CSS CALL BY IREADER ***; CALLCSS .CSS : 
CMDBUFFE EQU = . 
END 
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{ Svc 2 | 


3.5 SVC 2 CODE 26: FETCH DEVICE NAME 


SVC 2 code 26 searches for a user supplied volume name in the 
volume mnemonic table and returns the name of the device on which 
that volume is mounted. The format for the SVC 2 code 26 
parameter block is shown in Figure 3-4. 


ee ee EY ND SO ee Pe OY Ee OS ee ee OE RD Se ee SE ee ee oe 


O0(1) i1l(l) 
Reserved | Code s_—sifyx User H User H 
§ { i t 
' | t | 


SVC 2,parblk 


parblk ALIGN 4 


DB 0,26 2 
DB user register number 1 
DB user register number 2 


Figure 3-4 SVC 2 Code 26 Parameter Block Format and Coding 


This parameter block is four bytes long, fullword boundary 
aligned, and does not have to be ina writable segment of the 
task. The fields are described as follows. 


Fields: 
Reserved is a l-byte field that must contain a value of 
0 to indicate no options for this call. 
Code is a 1-byte field that must contain the 
decimal value 26 to indicate code 26 of SVC 2. 
User is a 1-byte field that must contain a 
register 1 user-specified register number. The specified 


register contains a pointer to a efullword 
containing a 4-character volume name. 


3-12 | 48-040 FOO RO2 


User 
register 2 


Possible condition 
follow: 


Condition Code: 


“eG 


ALIGN 
FTCHDEVN DB 

DB 

DB 
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is a 1-byte field that must contain a 
user specified register number. The specified 
register contains the address of the area 
receiving the device name. This area is 4 
bytes long, fullword boundary aligned, and 
must be located in a task writable segment. 


NOTE 
User register 1 and user register 


2 can specify the same register 
number. 


codes occurring after SVC 2 code 26 execution 


Normal termination. 


Specified volume offline; no fetch occurred. 


R1,MTMVOLN 
R2,MTMDEVN 
2,FTCHDEVN 


R2 


i SvC 2 | 


3.6 SVC 2 CODE 27: MEMORY MANAGEMENT 


Svc 2 code 27 allows a task to access and modify entries (except 
shared ones) within the private segment table (PST) in its task 
control block (TCB). This SVC can only be called by tasks 
running on MAT machines. It is used by the virtual task manager 
(VTM) support routines. The format for the SVC 2 code 27 
parameter block is shown in Figure 3-5. 


Ce ee ee eh i i ee ee a ee ee a Re he Re ee ee et he ee 


10(0) ;1¢1) {}2(2) User i3(3) User ' 
| Option i Code { register 1 {| register 2 |} 
| (SV227.0P) {| =(SV227.CD) | =(SV227.R1) | £=(SV227.R2) | 
cee ee ee ce nem Same ns mm teem Om oO mn mee) me sae mW co anv mon me Om orm wu nam Ome mee enw eens On ome mw ue cw sy fee ome a cm es cm coe ee ee ee ee oe ee i 


A (destination buffer) 
(SV227 .BF) 


SVC 2,parblk 


ALIGN 4 
parblk DB option,27,regl,reg2 
DAC BUFFADR 


Figure 3-5 SVC 2 Code 27 Parameter Block Format and Coding 


This parameter block is 8 bytes long, fullword boundary aligned, 
and located in a task writable segment. A general description of 
the parameter block follows. 
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Fields: 


Option 
(SV227 .OP) 


is a l-byte field that contains a decimal 
number specifying one of the following option 
codes: 


OPTION FUNCTION 


CODE 


0 


1 


2 


Code 
(SV227.CD) 


User 
register 1 
(SV227.R1) 


User 
register 2 
(SV227 .R2) 


A 
(destination 
buffer ) 
(SV227.BF) 
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EQUATE MEAN ING 


$V227.0 The first byte of each PST entry, 


starting at PSTE O and ending with the 
last private segment table entry (PSTE) 
of the task's impure segment (PSTE 
indicated by TCB.CTOP), is moved 
sequentially to a byte buffer specified 
by the SV227.BF field. After a byte is 
moved, the reference bit (bit 0) of 
each PSTE is reset. 


S$V227.1 Bits 15-31 of PSTE O are added to the 


user register specified by the SV227.Rl 
field. The result of the addition is 
stored in the PSTE identified by the 
number contained in the register 
specified by the SV227.R2 field. 


SV227.2 The value in user register 1 is stored 


in TCB.UTOP and the value in user 
register 2 is stored in TCB.CTOP. 


is a l-byte field that contains the decimal 
number 27 indicating code 27 of SVC 2. 


is a 1l-byte field that contains a 
user specified register number. If option 0 
is specified, this field is unused but must be 
reserved. 


is a 1-byte field that contains a 
user specified register number. If option 0 
is specified, this field is unused but must be 
reserved. 


is a 4-byte field that contains the address of 
the first byte of a user specified buffer to 
which the entries in the PST will be copied. 
This buffer should be located in a task 
writable segment. This field is omitted for 
options 1 and 2. 


SVC 2 code 


follows. 


Condition Code: 


iCiViGiLy 


' { 
10}0;0;0; 
( 


1 
;O;O;O{ 1} 


J 
1OlO;1;0} 


iO; 1j;O0{O0; 
tb Li0;0;0; 


i a ee 


27 sets the condition code field in the PSW as 


SVC 2 code 27 completed. No errors. 


Size of PST entry exceeds task allocation of 
memory. Entry not stored in PST. 
Illegal PST entry number. 


Shared bit set in PST entry. This entry cannot 


be modified. 
Value of UTOP is greater than value of CTOP. 
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3.7 SVC 6: SYSTEM TASK RELEASE 


The SVC 6 release function can be used by a system task 
(.CMDP, .CSL, .MTM, and .SPL) to remove another task from a 
suspended state. After the task is released, it continues 
execution at the location specified in the SVC6.SAD field of the 
SVC 6 parameter block. If this SVC is used by other than a 
system task, the continuation address (SVC6.SAD) is ignored. 
Figure 3-6 shows the parameter block format and coding for the 
SVC 6 release function for system tasks. 
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oe a OP SE eS SS ee OS See ee Se GP ED cee me er cay eee ee eee ee ee ee ee ee ee ee es ee ee ee 


i 
H 
Name of task H 
eae receiving SVC6 Sas 
4(4) (SVC6.ID) 


18(8) H 
Function code i 
H (SVC6.FUN) H 
pose oss SSeS SS rea See ee aS ee Sa eee eee eS H 
{12(C) }14(E) H 
' Reserved | Error status H 
(SVC6.TST) (SVC6.STA) 
[eee a ea SSeS SSS ae eee ae ea ee a ee eae j 
116(10) H 
Reserved 
H (SVC6.LU) i 
a a aaa a al ad a ah aon H 
120(14) H 
H Continue address of directed task H 
H (SVC6.SAD) | 
ber SSS SSS a4 saa SS SSeS SS ee a ee a eee eee Se H 
424(18) L 
Reserved 
(SVC6.TIM) 
T44(2C) Tv 


svc 6,parblk 


ALIGN 4 
parblk DC C'8-byte name of task receiving SVC 6' 
DC Y¥'80000080' 


DC H'O' 
DC H‘O' 
DC 0 


DC A(START) 
DC 0,0,0,0,0,0 


Figure 3-6 SVC 6 Release Function Parameter Block 
Format and Coding 


This parameter block must be 48 bytes long, fullword boundary 
aligned, and located in a task writable segment. A general 
description of each field in the parameter block follows. 
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Fields: 


Name of task 
receiving 
SVC 6 
(SVC6.ID) 


Function code 
(SVC6 .FUN) 


Reserved 
(SVC6.TST) 


Error status 
(SVC6 .STA) 


Reserved 
(SVC6.LU) 


Cont inue 
address 

of directed 
task 

(SVC6 .FUN) 


Reserved 
(SVC6.TIM) 
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is an 8-byte field containing the name of the 
task to which SVC 6 is directed. This name 
must be left-justified with blanks. 


is a 4-byte field containing the hexadecimal 


number Y¥'80000080' indicating that the release 


function is to be performed. 


is a reserved halfword field that must contain 
a zero. 


is a 2-byte field that receives an error code 
when an error occurs during SVC 6 execution. 
If no error occurs, a value of O is stored in 
this field. See the OS/32 Supervisor Call 
(SVC) Reference Manual for a listing of SVC 6 
error codes. 


is a reserved fullword field that must contain 
a zero. 


is a fullword field that contains the address 
at which the directed task is to resume 


execution after it$is released. If this field 
contains a zero, execution continues at the 
location at which the task was suspended. If 


this option is specified and the task issuing 
the SVC is not a system task, this field is 
ignored. 


is a reserved 24-byte field that must contain 
zeros. 


wee ee wee 


3.8 SVC 7: EXTENDED FUNCTIONS FOR PRIVILEGED TASKS 


The OS/32 file manager provides additional resource management 
services to privileged tasks. These services are accessed 
through the extended function codes of SVC 7. These functions 
include: 


e bare disk assignment, 
e fetch attributes for bare disk devices, 
@e device rename and reprotect, and 


® extended close. 


The following sections describe how to access the SVC 7 extended 
functions for privileged tasks. 


3.8.1 SVC 7: Bare Disk Assignment 


An e-task, privileged u-task, or d-task with bare disk privileges 
can bypass the file manager and directly assign to a disk device. 
When such a task issues an SVC 1 I/O request directly to a disk 
device, the operation is referred to as bare disk I/O and should 
always be random access. The supported I/O functions are read, 
write, and test and set. 


Direct assignment to a disk device can be performed only by a 
task that has the bare disk task option enabled. E-tasks always 
have this option enabled. A u- or d-task is given bare disk 
privileges by specifying the disk privilege option in the OPTION 
command (OPTION DISC) when the task is built by Link. However ,. 
if the task loader has the e-task option prevented, the 
privileged task is loaded into memory with the bare disk 
privilege option changed to the default, no bare disk privilege. 
Therefore, bare disk I/O cannot be performed by the task. 


The SVC 7 parameter block and coding for bare disk assignments 
are shown in Figure 3-7. 
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10(0) | '2(2) Error '3(3) 
H Function code {| status code } lu i 
i (SVC7.OPT) i (SVC7.STA) ! (SVC7.LU) i 
\ pcos salesmen calendar a 
14(4) | 
| Reserved H 
i (SVC7 .WKY ) } 
a rnc a em a a aa ta gee a H 
1}8(8) 
H Device mnemonic i 
| (SVC7.VOL) { 
i a SN ec a aca ela a aa al a a as ae I eT (ess ale“ snc ‘apdk “ae wala lb ili oh sibs lay "idea slant slo “ea” Subs” Sls bl oc fume sas a i 
{12(C) 
H 
{ H 
pr RR H 
16(10) Reserved a 
(SVC7 .FNM) 

ae T 
Pees seer 
124(18) 
H 
H 

SVC 7,parblk 

ALIGN 4 

parblk DC X' function code‘ 

DB 0 

DB lu 

DC 0 

DC C'4-character device mnemonic' 

DC 0,0,0,0 


Figure 3-7 SVC 7 Bare Disk Assignment Parameter Block 
Format and Coding 


This parameter block must be 28 bytes long, fullword boundary 
aligned, and located in a task writable segment. A description 
of each field in the parameter block follows. 
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Fields: 


3-22 


Function 
code 
(SVC7.OPT) 


Error 
status 
codes 
(SVC7.STA) 


lu 
(SVC7 .LU) 


Reserved 
(SVC7 .WKY ) 


Device 
mnemonic 
(SVC7 .VOL) 


Reserved 
(SVC7 .FNM) 


is a 2-byte field that contains the 
hexadecimal number indicating the assign 
function (bit 1 must be set). In addition, 
the appropriate access privileges (bits 8 
through 10) must be set as follows: 


e 000 = Shared Read-Only (SRO) 
e 001 = Exclusive Read-Only (ERO) 
e 010 = Shared Write-Only (SWO) 
@e O11 = Exclusive Write-Only (EWO) 
e 100 = Shared Read/Write (SRW) 
@ 101 = Shared Read, Exclusive Write (SREW) 
e 110 = Exclusive Read, Shared Write (ERSW) 
e lll = Exclusive Read/Write (ERW) 
CAUTION 
IF THE BARE DISK IS MARKED ONLINE, 
ONLY ASS IGNMENTS FOR SRO ARE 
ALLOWED. ANY OTHER ACCESS 
PRIVILEGE Is REJECTED, AND A 


PRIVILEGE ERROR STATUS (07) IS 
GIVEN. 


is a l-byte field that receives an error 
code when an error occurs during SVC 7 
execution. If no error occurs, a value of 
O is return to this field. See the 0S/32 
Supervisor Call (SVC) Reference Manual for a 
list of SVC 7 error status codes. 


is a l-byte field that contains a 
hexadecimal number indicating the logical unit 
to be assigned to the bare disk device. 


is a 4-byte reserved field that must 
contain a zero. 


is a 4-byte field containing the device 
mnemonic of the bare disk device. 


is a 16-byte field that must be reserved with 
zeros. 
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3.8.2 SVC 7 Code 0: Fetch Attributes for Bare Disk Devices 


The fetch attributes function fetches the attributes of a bare 
Gdisk device through its assigned logical unit (lu). The write 
attribute is reset in the attributes halfword field (SVC7.ATRB) 
of the parameter block if the disk is marked on protected. 


This SVC 7 function is available only to tasks with bare disk 
privileges or to e-tasks. Before issuing this SVC, the task must 
have the bare disk already assigned to the lu. Figure 3-8 shows 
the parameter block format and coding for SVC 7 code 0. 


eR CTE UT SRD eR RR LO a EN OY A sa em SS RDO ine SE ST OD GD tt ED CED GS ee eR ee eee ee OO a Me GD GD ie A me ey ee 


10(0) i1(1) 12(2) 13(3) 
1 Option code {| Device code |} Status H lu H 
{ { { 4 
Fe es ee oes ee a a eed : 
14(4) 16(6) 
H Attributes H Device number H 
f 
Fe Baha eee : 
18(8) 
Volume 
ea a al a a ec a 
112(C) ! 
| Flags 
! | 
H Ss Sem SS ne sa as ns ah nt Vase Sco lbs lh Go ec Sema ett Sa esas vo ew em dws Se ee oy na on ea aa ee es H 
{16(10) 
i Size H 
[SaaS eS aoe SaaS ep ae ae ee eS ee eee Se eae 
120(14) 122(16) 
H Tracks per cylinder | Sectors per track 
| H 
[Rese Ss SS SaaS Sa Seon SSeS eS SSeS Sea eS eee eee eS 
124(18) 126(1A) 
H Controller address | SELCH address H 
i 
SVC 7,parablk 
ALIGN 4 
parblk DB 0 
DS 2 
DB lu 
DS 24 


Figure 3-8 SVC 7 Code O Parameter Block Format and Coding 
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This parameter block must be 28 bytes long, fullword boundary 
aligned, and located in a task writable segment. A general 
description of each field in the parameter block follows. 


Fields: 


Option 


Device code 


Status 


lu 


Attributes 


Device number 


Volume 
Flags 

Size 
Tracks per 


cylinder 


Sectors per 
track 


Controller 
address 


SELCH 
address 


is a l-byte field that must contain xX'00' to 
indicate the fetch attributes function code. 


is a l-byte field that receives the device 
code of the bare disk device. 
is a l-byte field that receives the return 


status of the bare disk device. 


is a Il-byte field that must contain the 
logical unit for which attributes are 
returned. 


is a 2-byte field that receives the attributes 
of the bare disk device. 


is a 2-byte field that receives the device 
address of the bare disk. 

is a 4-byte field that receives the device 
mnemonic for the bare disk. 

is a 4-byte field that receives the device 


flags for the bare disk. 


is a 4-byte field that receives the number of 
sectors on the bare disk. 


is a 2-byte field that receives the number of 
tracks per cylinder on the bare disk. 


is a 2-byte field that receives the number of 
sectors per track on the bare disk. 


is a 2-byte field that receives the controller 
address for the bare disk device. 


is a 2-byte field that receives the selector 
channel address for the bare disk device. 
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3.8.3 SVC 7: Device Rename 

E-tasks can use the SVC 7 rename function to rename devices. The 
e-task must have the device already assigned to the lu with ERW 
access privileges. 


The SVC 7 parameter block format and coding for renaming devices 
is shown in Figure 3-9. 


10(0) {2(2) Error 13(3) i 
i Function code | status code } lu | 
H (SVC7.OPT) | (SVC7.STA) { (SVC7.LU) | 
Pe SSSSsS SSeS SSeS SSeS SSS aaa eee ea See See ee See ei 
14(4) H 
i Reserved } 
H (SVC7 .WKY ) H 
Teter a na ee 
18(8) ! 
| Device mnemonic H 
H (SVC7.VOL) i 
(SSeS oe SS SSS ee eae eae eS See ea ee H 
} 12(C) 
H H 
H H 
aoa rr } 
416(10) Reserved LL 
(SVC7.FNM) 

Verere nee T 
124(18) 
i H 
| ! 

SVC 7,parblk 

ALIGN 4 

parblk DC X'1000' 

DB 0 

DB lu 

DC 0 

DC C'4-character device mnemonic' 

DB 0,0,0,0 


Figure 3-9 SVC 7 Device Rename Parameter Block 
Format and Coding 
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This 


parameter 


block must be 28 bytes long, 
aligned, and located in a task writable segment. 


fullword boundary 
A description 


of each field in the parameter block follows. 


Fields: 
Function is a 2-byte field that contains the 
code hexadecimal number X‘'1000° indicating that the 
(SVC7.OPT) rename function is to be performed. 
Error is a 1l1-byte field that receives an error 
status code when an error occurs) during svc 7 
codes execution. If no error occurs, a value of 0 
(SVC7.STA) is returned to this field. See the 0OS/32 
Supervisor Call (SVC) Reference Manual for a 
list of SVC 7 error status codes. 
lu is a l-byte field that contains a hexadecimal 
(SVC7.LU) number indicating the logical unit assigned to 
the device that is to be renamed. 
Reserved is a 4-byte reserved field that must’ contain 
(SVC7 .WKY ) a zero. 
Device is a 4-byte field containing the device 
mnemonic mnemonic that is to replace the current device 
(SVC7 .VOL) mnemonic in the device mnemonic table. 
Reserved is a 16-byte field that must be reserved with 
(SVC7.FNM) zeros. 
3.8.4 SVC 7: Device Reprotect 
E-tasks can use the SVC 7 reprotect function to define the type 
of access allowed to a device (e.g., read only, write only, 
etc.). The e-task must have the device already assigned to the 
lu with ERW access privileges. 
The SVC 7 parameter block format and coding for reprotecting 


devices is shown in Figure 3-10. 
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10(0) '2(2) Error {3(3) 
H Function code | status code |} lu i 
H (SVC7.OPT) H (SVC7.STA) H (SVC7.LU) | 
a aan aa al a a a aa a! i 
14(4) 15(5) 16(6) 
| Write key jj Read key H Reserved H 
' (SVC7.WKY) H (SVC7.RKY) { (SVC7.IRC) { 
a a a a a aa a a as a al at H 
1$8(8) H 
H H 
Weta es ieee meso a a i ee RS { 
t ! 
{ ‘ 
ay A 
Reserved 

~ (SVC7.VOL) . T 
parree< oO CO | 
{}24(18) 
H H 
i H 

SVC 7,parblk 

ALIGN 4 

parblk DC X'O0800' 

DB 0 

DB lu 

DB ‘write key' 

DB ‘read key' 

DC H‘'O' 

DC 0 


DB 0,0,0,0 


Figure 3-10 SVC 7 Device Reprotect Parameter Block 
Format and Coding 


This parameter block must be 28 bytes long, fullword boundary 
aligned, and located in a task writable segment. A description 
of each field in the parameter block follows. 
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Fields: 


Function is a 2-byte field containing the hexadecimal 
code number X'O0800' indicating that the reprotect 
(SVC7.OPT) function is to be performed. 
Error is a l-byte field that receives an error code 
status when an error occurs during SVC 7 execution. 
codes If no error occurs, a value of O is returned 
(SVC7.STA) to this field. See the OS/32 Supervisor Call 
(SVC) Reference Manual for a list of SVC 7 
error status codes. 
lu is a l-byte field that contains a hexadecimal 
(SVC7.LU) number indicating the logical unit assigned to 
the device that is to be reprotected. 
Write key is a l-byte field that contains a hexadecimal 
(SVC7 .WKY ) number indicating the new write protection 
keys for the device. 
Read key is a l-byte field that contains a hexadecimal 
(SVC7.RKY) number indicating the new read protection keys 
for the device. 
Reserved is a 2-byte reserved field that must contain 
(SVC7.LRC) a zero. 
Reserved is a 20-byte unused field that should be 
(SVC7.VOL) initialized with zeros. 
3.8.5 SVC 7 Code X'FF80': Extended Close Function 
The extended close function closes an lu and replaces the date 
and time of allocation and the last write (or write filemark) 
operation in the disk directory with information stored in the 


sVC 


7 parameter block. 


This SVC 7 function is available only to 


e-tasks or privileged u-tasks and d-tasks with the bare disk task 
option enabled. 


Figure 3-11 shows the parameter block format and coding for SVC 


7 code X'FF80'. 


48-040 FOO RO2 


10(0) 12(2) 13(3) | 
Function code | Error status } lu 
i i i i 
[eRe Rne OES anne ae seen aa ee ee ee re eee Lane aaa 
14(4) 
{ Allocation date/time ' 
H (moved into DIR.DATE) H 
Oa Ns a a a ac ce Se as a cs sak a ee a a sas aw a mat vee ness ses Sas ats aed ees ac vi” esc els mem { 
18(8) 
H Last write operation date/time H 
' (moved into DIR.LUSE) { 

SVC 7,parblk 

ALIGN 4 

parblk DC X*FF80’ 

DB 1 

DB lu 

Dc Y'allocation date/time’ 

DC Y' last write operation date/time’ 


Figure 3-ll SVC 7 Code X°FF80‘' Parameter Block 
Format and Coding 


This parameter block must be 12 bytes long, fullword boundary 
aligned, and located in a task writable segment. A general 
description of each field in the parameter block follows. 


Fields: 


Function code is a 2-byte field that contains the function 
code X'FF8O' indicating that the Svc 7 
extended close function is to be performed. 


Error status is a l-byte field that receives an error code 
when an error occurs during SVC 7 execution. 
If no error occurs, a value of O is’ returned 
to this field. If a non-privileged task 
attempts to execute this SVC, a value of 1 is 
returned. See the OS/32 Supervisor Call (SVC) 
Reference Manual for a list of SVC 7 error 
codes. 
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Allocation 
date/time 


Last write 
operation 
date/time 


is a 4-byte field that contains the date and 
time that is to replace the date and time of 
allocation in the DIR.DATE field of the disk 
directory. The format of the date and time 
must be the same format generated by the 
DATE.DIR routine in the file manager utility 
(FMUT) module. 


is a 4-byte field that contains the date and 
time that is to replace the date and time of 
the last write operation in the DIR.LUSE field 
of the disk directory. The format of the date 
and time must be the same format generated by 
the DATE.DIR routine in the FMUT module. 
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3.9 SVC 13: AUXILIARY PROCESSING UNIT (APU) CONTROL 


SVC 13 provides a task with an interface to the APU in a Model 
3200MPS System environment. SVC 13 gives a task the ability to: 


@® access status information on all APUs in the system, 
e direct the flow of tasks to an APU, and 


e direct the execution of tasks on an APU. 


Table 3-3 lists the SVC 13 function codes which provide’ these 
capabilities. 


Functions O and 1 are available to any task in a Model 3200MPS 
System. Function 2 is available only to tasks in a Model 3200MPS 
System that have been linked with the APMAPPING task option. 
Function 3 is available only to tasks in a Model 3200MPS System 
that have been linked with the APCONTROL task option. See the 
OS/32 Link Reference Manual for more information on building a 
task with these task options set. 


TABLE 3-3 SVC 13 FUNCTION CODES 


|} FUNCTION CODE |} MEAN ING } 
{ Rr2VSrSs SS Sr SF SSS StS SeST SKEETER S ST SSB SVS ST SESS SSS SSS SST ST 
SVC 13 code 0 } Fetch logical processor 
mapping table (LPMT). 


SVC 13 code l1 Fetch APU status. 


SVC 13 code 2 Execute APU mapping option. 


SvC 13 code 3 Execute APU control option. 


ee ee a SS Ga ee RS ee eS GE See Sm meme mee me eps NS OD OO A) oe me ee mS OD Oe ee NE te ee en ce ie ee ee ee 


The following sections describe how to access each of the SVC 13 
functions from an application task running on a Model 3200MPS 
System. 
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3.9.1 Svc 13 Code O: Fetch Logical Processor Mapping Table 
(LPMT ) 


The LPMT is. an OS/32 data structure that defines the relationship 
between the logical processing units (LPUs) assigned to tasks and 
the APUs of the system. The LPMT contains one entry for each LPU 
number. In addition to the LPU entries, the LPMT contains’ the 
maximum LPU and APU numbers) allowed on the system. Each LPU 
entry is l-byte, sequentially arranged, starting with the entry 
for LPUO (which is always mapped to the CPU) and ending with the 
entry for LPUn. The maximum value for n is determined at 0S/32 
sysgen. See the OS/32 System Generation (SYSGEN/32) Reference 
Manual. 


When an APU is mapped to an LPU, its number is placed into the 
byte corresponding to the LPU entry in the LPMT. SVC 13 code O 
allows a task to copy the LPMT into a data buffer located in a 
writable segment of the task's address space. This buffer must 
begin on a fullword boundary. Figure 3-12 shows the parameter 
block and coding for SVC 13 code O. 


10(0) ;1(1) 12(2) 13(3) ' 
H Reserved {Function code} Reserved i Reserved H 
H (SV13 .OPT) { (SV13.FUN) | (SV13 .DOP) { (SV13 .APU) H 
takes aia ci Ree Said ene eRe aS eae 
14(4) 16(6) i 
{ Reserved { Error status code { 
i (SV13 .APS) { (SV13 .ERR) { 
a a a a a a a a ge ca a 1 
8(8) 


(SV13 .BUF ) 


{ 
! 
i Data buffer start address 
{ 
| 


_ 
ho 
v~“-_ 
Q 
—__ 
I 
> 
~ 
ea} 
Sea” 


t 

’ 

1 Buffer used Length of buffer 
(SV13 .USE) (SV13 .LEN) 


CN ee ee ee ee se ee 


SVC 13,parblk 


ALIGN 4 


parblk DB 0,0,0,0 
DB H'O' 
DS 2 
DC H'number of bytes' 


Figure 3-12 SVC 13 Code O Parameter Block Format and Coding 
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This parameter 


block must be 16 bytes long, fullword boundary 


aligned, and located in a task writable segment. A general 
description of each field in the parameter block follows: 


Fields: 


Reserved 
(SV13 .OPT) 


Function code 
(SV13 .FUN) 


Reserved 
(SV13 .DOP) 


Reserved 
(SV13 .APU) 


Reserved 
(SV13 .APS) 


Error 
status code 
(SV13 . BUF ) 


Data buffer 
start address 
(SV13 .BUF ) 


Buffer used 
(SV13 .USE) 


Length of 
buffer 
(SV13 .LEN) 


is a 1l-byte unused field that should be 
initialized to zero. 


is a l-byte field that must’ contain the 
decimal number O to indicate code O of SVC 13. 


is a 1l-byte unused field that should be 
initialized to zero. 


is a 1-byte unused field that should be 
initialized to zero. 


is a 2-byte unused field that should be 
initialized to zero. 


is a 2-byte field that receives the execution 
status of SVC 13 code 0. See Table 3-10 for 
a list of the SVC 13 status codes. 


is a 4-byte field that contains the address of 
a user specified buffer to which the operating 
system returns an exact copy of the LPU 
entries in the LPMT, including reserved 
fields, the sign of each LPU entry, the 
maximum LPU number, and the maximum APU 
number. The buffer can be variable in length 
but must begin on a fullword boundary in a 
task writable segment. 


is a 2-byte field that receives the actual 
number of bytes used in the buffer specified 
by the SV13.BUF field. 


is a 2-byte field that contains a decimal 
number indicating the maximum length (in 
bytes) of the data buffer specified in the 
SV13.BUF field. 


When SVC 13 code O is executed, APU assignment information is 
returned to the user's buffer in the format shown in Figure 3-13. 
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10(0) p1(1) 12(2) 13(3) 
Hi Reserved |} Maximum APU } Maximum LPU | LPU entry H 
i i number | number H width H 
Tae ac | 
14(4) 
H LPU to APU mapping array H 

{ 

5 


Figure 3-13 Data Buffer Format for SVC 13 Code 0 


A general description of the fields in the APU mapping data 
buffer follows: 


Fields: 


Reserved is a l-byte field that is reserved for future 
use. 

Maximum APU is a l-byte field containing the maximum APU 

number number allowed in the system. This number is 
determined at OS/32 sysgen. 

Maximum LPU is a 1-byte field containing the maximum LPU 

number number allowed in the system. This number is 
determined at OS/32 sysgen. 

LPU entry is a l-byte field containing the width (in 

width bytes) of each LPU entry in the LPMT. 

LPU to APU is a variable length array (O:MAXLPU) contain- 

mapping array ing the LPU to APU mapping assignments. The 


index to the array corresponds to the LPU 
number. The entry at that index into the 
array contains the APU ID of the APU mapped to 
the LPU. 


3.9.2 SVC 13 Code 1: Fetch Auxiliary Processing Unit (APU) 
Status 


SVC 13 code 1 allows a task to access information on the status 
of each APU in a Model 3200MPS System. When executed, SVC 13 
code 1 returns the following status information on the’ specified 
APU to the requesting task's buffer: 


e The names of all tasks in the APU ready queue (or name of task 
having exclusive rights to the APU) 
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e The APU processing status 
e The status of writable control store (WCS) 


e The task currently active on the APU (or the waiting task if 
the APU is stopped) 


e The name of the task with control rights over the APU 
e The name of the task with mapping rights over the APU 
e The number of LPUs mapped to the APU 

e The configuration options set for the APU 


Figure 3-14 shows the parameter block format and coding for SVC 
13 code l. 


10(0) {1(1) 12(2) 13(3) 
| Reserved } Function code} Reserved i; APU number H 
i (SV13 .OPT) H (SV13 .FUN) | (SV13 .DOP) i (SV13 .APN) | 
a an aa sh oo tc i 
14(4) 16(6) 
H APU hardware status | Error status code H 
i (SV13 .APS) ‘ (SV13 .ERR) i 
hea ese aes Sacks et Sst Saleh ph tld ak su ha Ses Sou te Sts ns cl <a st ea ela gt aga Ce i ac a So ae mci cae “aks Nasal de WA Gaon ale da ee H 
18(8) 
| Data buffer start address H 
H (SV13 . BUF ) | 
ss scawq cel caspases mss iS mi pink er moi: wtb ms mic, ns gna in-game i a ‘Ss i a ac Ss i ec as SR cea i 
j}12(C) i L4(E) 
Buffer used i Length of buffer 
i (SV13.USE) | | (SV13 .LEN) H 


parblk ALIGN 4 


DB 0,1,0 

DC ‘APU number ' 

DS 4 

DC A(buffer) 

DS 2 

DC H'number of bytes in buffer' 


Figure 3-14 SVC 13 Code 1 Parameter Block Format and Coding 
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This parameter block must be 16 bytes long, fullword boundary 
aligned, and located in a task writable segment. A general 
description of each field in the parameter block follows. 


Fields: 
Reserved is a 1l-byte unused field that should be 
(SV13 .OPT) initialized to zero. 
Function code is a 1l-byte field that must contain the 
(SV13 .FUN) decimal number 1 to indicate code 1 of SVC 13. 
Reserved is a l-byte unused field that should be 
(SV13 .DOP) initialized to zero. 
APU number is a l-byte field specifying a decimal number 
(SV13 .APN) (0 through 9) indicating the number of the APU 


to which this call is directed. 


APU hardware is a 2-byte field that receives the APU 


status response status from the APU processor 

(SV13 .APS) hardware. See Section 3.9.5 for more 
information on the status codes returned to 
this field. 

Error status is a 2-byte field that receives the execution 

code status of SVC 13 code 1. See Table 3-10 for a 

(SV13 .ERR) list of the SVC 13 status codes. 

Data buffer is a 4-byte field containing the address of a 

start address data buffer to which SVC 13 is to return the 

(SV13 . BUF ) APU status information. The buffer can be 


variable in length, but it must begin ona 
fullword boundary and be located in a task 
writable segment. If the buffer is less than 
8 bytes in length, an error code (insufficient 
buffer space) will be returned and no data 
will be written to the buffer. 


Buffer used is a 2-byte field that receives a decimal 

(SV13 .USE) number indicating the actual number of bytes 
used in the buffer specified by the SV13.BUF 
field. 

Length of is a 2-byte field that contains a decimal 

buffer number indicating the maximum length (in 

(SV13 . LEN) bytes) of the data buffer specified in the 


SV13.BUF field. 


When SVC 13 code 1 is executed, information on the status of the 
specified APU is returned to the user's buffer in the format 
shown in Figure 3-15. 
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ee ee ee ee ee ee ee 


APU number 


ee Le eS A a YY 


APU software status 


12(2) 
| Number of 
H LPUs mapped } 


Active task name 
or 
Waiting task name 


Cee Mice A ee ae en ce A A I ne ee ee ee eee ee eee 


Control task name 


24(18) 


Mapping task name 


Ready task name (1) 
or 
Exclusive task name 


ee ee ee ee ee ee ee) 


care ems ame mm em em teem em ee ee te een meer Oe et ee em mG em mentee cee mm ee eS AE) SO SA GE me Sy oe rms re mn meee Ge OR SY ee SE le Oe SY ED eee mee Ce me tee 


Ready task name (N) 


Figure 3-15 Data Buffer Format for SVC 13 Code l 
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A general description of the fields in the data buffer for SVC 13 
code 1 follows. 


Fields: 


APU number 


Number of 
LPUs mapped 


Number of 
tasks 


APU software 
status 


is a l-byte field containing the number of the 
APU to which the status information applies. 


is a l-byte field containing the number of 
LPMT entries mapped to the specified APU. 


is a 2-byte field containing the total number 
of tasks waiting in the specified APU's' ready 
queue. Any task currently executing on the 
APU is not included in the total. 


is a 2-byte field that contains the current 
software status of the APU, the status after 
the last power fail, and the state of the WCS 
for the specifed APU. 


Figure 3-16 shows the APU software status 
field. See Table 3-4 for the bit definitions 
for this field. 


Current 


i Last power | H 
i } Reserved ! status 


failure status} 


Figure 3-16 Format of APU Software Status Field Returned 
to Task Buffer 
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TABLE 3-4 BIT DEFINITIONS FOR APU SOFTWARE STATUS 
FIELD RETURNED TO TASK BUFFER 


H BIT i H 
|} APU STATUS {| POSITION ]| BIT SETTING AND MEANING ' 
H rT TteTrTerSTEerte es Ste te FZ FTES ET ES SHEERS ES SET SESE KEE TSE See ee res ss =e i 
i} WCS state jf 0 i 1 = WCS initialized H 
| i | 0 = WCS not initialized H 
ae aa a ae al a cl Ca a aad H 
H H 1 { 1 = WCS loaded 1 
H | H 0 = WCS not loaded i 
tester aan it teat rtaractacaataaiaatatecetanatataeatanerarananii | 
| Reserved 2-4 
| for future | H H 
i use 
[See he SSS SSS SS SSeS ee Sere hee Sees See ee ee H 
i; Status 5 i 111 = APU on and waiting 
| after last } i for task _ 
| power H 6 } 110 = APU on exclusive and i} 
| failure i | waiting for task j 
H i 7 { O11 = APU on i 
H | { 010 = APU on exclusive | 
H | {} OO1 = APU off { 
| PaaS SSeS SSeS Hee eae eS eee Se ee i 
| Reserved | 8-12 } { 
| for future } H i 
| use 
(a Seat See See See eS SSS a eS ae Se a ee eee eee H 
; Current i 13 } 111 = APU on and waiting 
i} status H 14 H for task | 
| H 15 } 110 = APU on exclusive and 
i H waiting for task H 
H H {! O11 = APU on t 
| | } 010 = APU on exclusive H 
H } OO1 = APU off H 
| { { 0OO = APU disabled H 
APU options is a 2-byte field that is set accord ing to the 
configuration options in effect for the 


specified APU. See Table 3-5 for the bit 
definitions for this field. 
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TABLE 3- 


! APU 

|} CONFIGURATION 
i OPTION 

\ emer error eee es 


WCS 


Floating 
point support 


Trap block 
wait 


{ Reserved for 
{| future APU 
| options 


Active task 
name or 
waiting task 
name 


Control 
task name 


Mapping task 
name 


5 APU OPTIONS FIELD BIT DEFINITIONS 


' 
H BIT H H 
|} POSITION } BIT SETTING AND MEANING H 
BED SEERA EES S RESTS SSS SS SESS SOS SESS SS ESSE SR ST { 
O = APU has WCS i 

= APU has no WCS i 

iTable “se Sata iid cb sec en esl ea sg’ ca ic eS sc "cs Vn mn alg’ AS? wo ects“ wis mad “else asl ‘ 
O = APU has floating point | 

support H 

1 = APU has no floating H 
point support H 

To ssi eae. Si <a soi. ‘lc. Sag San Se alo Sa. ol Snel: nm Sei ee tg, ‘hc ia Si aa ey “i su i: Ni Soe { 
{} O = APU will continue pro- |} 
H cessing during CPU i 
i fault handling i 
} L = APU will stop process- jj} 
| ing and wait for a task |} 
i during CPU fault H 
i handling H 
{ 


is an 8-byte field containing the name of the 
currently active task. If the APU is’ stopped 
and waiting for a task, this field contains 
the name of the currently waiting task. The 
task name is left-justified with trailing 
blanks. If no currently active or waiting 
task exists, the entire field is filled with 
blanks. 


is an 8-byte field containing the name of the 
task having control rights over the specified 
APU. If no control task exists, the entire 
field is filled with blanks. 


is an 8-byte field containing the name of the 
task having mapping rights over the specified 
APU. If no mapping task exists, the entire 
field is filled with blanks. 
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Ready task is a variable length table of 8-byte fields 


name (n) containing the name of each task in the ready 

Or queue of the specified APU. The order of 
Exclusive entries in this table corresponds to the order 
task name of the tasks on the APU ready queue. 


When the specified APU has been marked on 
exclusively for one task, the ready queue is 
always empty. In this case, this field 
contains the name of the task having exclusive 
rights to the specified APU. 


3.9.3 SVC 13 Code 2: Auxiliary Processing Unit (APU) Mapping 
SVC 13 code 2 allows a task to perform mapping functions on a 
specified APU, provided the task has the mapping rights to the 


specified APU. A task is granted mapping rights to an APU only 
it’ 


e the requesting task has been Link edited with the APMAPPING 
option, and 
e no other task has been granted mapping rights to that APU. 


Operator commands for APU mapping will not be accepted if a 
task already has these mapping rights. 


Once a task has been granted mapping rights to an APU, the task 
can: 

@e mark the APU on, 

e map the APU into the LPMT, 

@e remove all references to the APU from the LPMT, and 


@e mark the APU off. 


Figure 3-17 shows the parameter block format and coding for SVC 
13 code 2. 
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10(0) 11(1) 12(2) 13(3) 
Options ; Function code ; Directive option ; APU number } 
' (SV13.OPT) {| (SV13.FUN) H (SV13 .DOP ) | (SV13.APN) | 
[pee aaa Sens Senate aia aoe ae See ene ose eae eee 
14(4) i6(6) Error 1 
‘ Reserved | status code i 
1 (SV13.APS) H (SV13 .ERR) H 
ete setae ea eee na ee aa eS aie ae eee nee 
| 8(8) | 
Data buffer start address i 
(SV13 .BUF ) 
esconeeea cig aig acacia ang aca isarsinaian cae mein ies era a 
112(C) —414(E) 
Reserved Length of buffer 
| (SV13 .USE) i (SV13 .LEN) } 


ALIGN 4 
parblk DC X'option(s)' 
DB 2 
DC ‘LPU number’ or 0 
DC "APU number ' 
DC H'O' 
DS 2 
DC A( BUFFER) 
DC H‘'O' 
DC H'number of bytes in buffer’ 


Figure 3-17 SVC 13 Code 2 Parameter Block Format and Coding 


This parameter block must’ be 16 bytes long, fullword boundary. 
aligned, and located in atask's writable segment. A general 
description of the fields in this parameter block follows. 


Fields: 
Options is a l-byte field containing a hexadecimal 
(SV13 .OPT) number specifying one or more of the following 


mapping options: 
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Function code 
(SV13 .FUN) 


Directive 
option 
(SV13 .DOP) 


APU number 
(SV13 .APN) 


Reserved 
(SV13 .APS) 


Error status 


code 
(SV13 .ERR) 
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OPTION 


CODES FUNCTION 

xX'80' Gain mapping rights for specified 
APU. 

X'40' Mark APU on, exclusive to only one 
task. 

X'20' Mark APU on (taskKs can be added to 
APU queue). 

X'10' Map APU into LPMT at  LPUn. (n is 


indicated by the directive option 
field at SV13.DOP.) If APU = O, LPUn 
is mapped to the CPU. 


x'O8' Remove all references to the 
specified APU from the LPMT. 


xXx'O2' Mark APU off (removes all tasks from 
APU and APU queue). 


X'Ol' Release task's mapping rights for the 
specified APU. 


NOTE 


If two or more of the above option 
bits are specified, they are 
executed in a left-to-right order. 


is a 1-byte field that must contain the 
decimal number 2 to indicate code 2 of SVC 13. 


is a 1l-byte field that contains the LPU 
number for option X'10'. All other options 
ignore this field. 


is a l-byte field that must contain the number 
of the APU to which this SVC is directed. 


is an unused 2-byte field that should be 
initialized to zero (0). 


is a 2-byte field that receives the execution 
status of SVC 13 code l. The first byte of 
this field indicates the bit position (0-7) of 
the SVC 13 code 2 option being executed when 
the error occurred. The second byte contains 
one of the SVC 13 error status codes. See 
Table 3-10. If no error occurs, both bytes 
contain 0. 


Data buffer is a 4-byte field that specifies the address 
start address of the buffer containing the name of the task 
(SV13 . BUF ) to be granted exclusive access to the 
specified APU. The task name specified in 
this buffer must be 8 bytes long and 
left-justified with trailing blanks. If the 
entire buffer is filled with blanks, the task 
issuing the SVC is granted exclusive access to 
the specified APU. This field applies to 
option X'40' only; all other options’ ignore 


this field. 
Reserved is a 2-byte unused field that should be 
(SV13 .USE) initialized to zero. 
Length of is a 2-byte field indicating the length of the 
buffer data buffer containing the name of the task to 
(SV13 .LEN) be granted exclusive access to the specified 
APU. 


This field applies to option X'40' only; all 
other options ignore this field. 
3.9.4 SVC 13 Code 3: Auxiliary Processing Unit (APU) Control 
SVC 13 code 3 allows a task to perform control functions on a 
specified APU provided the task has obtained the control rights 
to the specified APU. OS/32 grants APU control rights to a 
requesting task only if: 
e the task has been Link edited with the APCONTROL option, and 
@® no other task has been granted control privileges to the 


specified APU. Operator commands for APU control will not be 
accepted if a task already has these control rights. 


SVC 13 code 3 gives a task the ability to: 


e Initialize an APU (perform a power up link check). 
e Send a directive to control APU task execution. 
@ Stop the APU and preempt the currently executing task. 


@e Preempt the next ready task on the APU ready queue with 
another task selected from the queue. 


e Disable an APU for online maintenance. 


Figure 3-18 shows the parameter block format and coding for SVC 
13 code 3. 
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Ca I I etn Se ee 


10(0) APU 11(1) —12(2) 13(3) 
;control options} Function code ; Directive option ; APU number |} 
} (SV13.OPT) i} (SV13.FUN) H (SV13 .DOP) | (SV13.APN) } 
ema ce aaa a a aa ra ne aa 
14(4) 16(6) 
H Reserved H Error status code 
(SV13 .APS) ! (SV13 .ERR) 
(Sess ete = Soe See eee Se eee eee ae Se ee er eee eee See 
18(8) | 
Data buffer start address 
(SV13.BUF) © 
[a SSS Sa eee Sr Re SS aor eae eee eee te ee oe 
}12(C) ;}14(E) 
| Reserved H Length of buffer 
(SV13 .USE) H (SV13 .LEN) H 

SVC 13,parblk 

ALIGN 4 

parblk DB X' option’ 

DB 3 

DB X'directive option' 

DB "APU number ' 

DS 4 

DC A( BUFFER) 

DC H'O! 

DC H' length of buffer' 


Figure 3-18 SVC 13 Code 3 Parameter Block Format and Coding 


This parameter block must’ be 16 bytes long, fullword boundary 
aligned, and located in a task writable segment. A general 
description of each field in the parameter block follows. 


Fields: 
APU control is a l-byte field specifying a hexadecimal 
options number indicating the APU control option to 
~(SV13 .OPT) be executed. Figure 3-19 shows’ the APU 
control option field format. See Table 3-6 
for the available options for this field. If 


more than one APU control option is specified, 
the options are executed ina left-to-right 
order. 
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Function code 
(SV13 .FUN) 


Directive 
option 
(SV13 .DOP) 


APU number 
(SV13 .APN) 


APU hardware 
status 
(SV13.APS) 


Error status 
code 
(SV13 .ERR) 


Data buffer 
start address 
(SV13 .LEN) 


is a l1-byte field that must contain the 
decimal number 3 to indicate code 3 of SVC 13. 


is a l-byte field specifying a hexadécimal 
command code to be sent to the specified 
APU. See Table 3-7. This field is used only 
if X'O8* was specified in the APU control 
options field. The directive option field is 
ignored for all other APU control options. 


is a l1-byte field (one through the number of 
APUs in the system) that identifies the speci- 
fied APU. (APU 0 has no meaning here. By 
default all tasks have mapping and control 
rights to APU O but no other control functions 
are valid for APU 0). 


is a 2-byte field that will contain one 
of the following: 


e If option X'O8' is specified and any 
command other than Link check (X'80') is 
specified in the SV13.DOP field, this field 
receives the APU response status returned 
after execution of the specified byte. 


e If option X'08' is specified and the link 
check command (X'‘'80‘') is specified in the 
directive option (SV13.DOP) field, the 
right-most byte of the halfword defines a 
data pattern (determined by the user), 
which is sent to the APU. The APU 
complements the byte and sends it back to 
the left byte of the field. 


igs a 2-byte field that receives the execution 
status of SVC 13 code 3. The first byte of 
this field indicates the bit position of the 
option being executed when the error occurred. 
The second byte of this field contains one of 
the SVC 13 error status codes. See Table 3-10 
for a list of the SVC 13 error codes. 


is a 4-byte field that specifies the address 
of a buffer containing the name of the task 
on the APU ready queue that is to be selected 
as the next task to be executed. This task 
must be an existing member of the queue. 


This field applies to option X'10‘' only and is 
ignored for all other APU control options. 
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Reserved 
(SV13 .USE) 


is an unused 2-byte reserved field that should 
be initialized to zero. 


Length of is a 2-byte field specifying a decimal 
buffer number (8 or greater) indicating the length of 
(SV13 . LEN) the data buffer specified by the SV13.BUF 
field. This field applies to option xX'‘10' 
only and is ignored for all other APU control 
options. 
| Gain | | Stop and |;Preempt} Send jj }Release} 
;controljEnable|reschedule; task j; APU j}Reserved;|Disablejcontrol} 
irights |; APU |; APU task {| queue {command} i APU jrights 
Bits: 
0 1 2 3 4 5 6 7 


Figure 3-19 SVC 13 APU Control Options Field (SV13.OPT) 


TABLE 3-6 SVC 13 CODE 3 APU CONTROL OPTIONS (SV13.OPT) 
FIELD BIT DEFINITIONS 


APU CONTROL j; 
PRIVILEGE | 
OPTION H 


1 

1 

BIT H 

POSITION } CODE { DESCRIPTION ' PREREQUISITES H 

Sets SeSsese3s2S2S2SS2 22 S232 S22 SEBS BS 2E2ES BS SFBBZESEBRBBZEEBAABDAAZA SBA B*ASEABEBESCAAASEBZEABAA BTS ST FT = H 

0 ; X'80' }| Task gains control ; Task link edited ;} 

H { rights to the ' with APCONTROL H 

\ } specified APU. | task option. H 

t 4 | ! 

' i] i) + 

H } ! No other task t 

| i ' has control } 

H { rights to ' 

i H ' specified APU. : 

1 -_——— = ae ee ee ee ee ee ee ee ee ee ee eee ee ee ee ee eee ee ee ee ee ee ee ee oe ee ee om ee ee ee em ee See on Gee gee me cee oe ee ee ee wee es ee ee eee eee eee 

1 X'40' Initializes speci- APU must be in 


Enable APU 
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i 
| HEX H 
4 ‘ 


( t 
' ' 
i fied APU by per- | disabled state. 
| forming a power up |} 
| Link check. After | 
} power up link H 
; check, APU is in H 
} an OFF and IDLE H 
' state. 1 


ew we we we we we we we oe 


TABLE 3-6 SVC 13 CODE 3 APU CONTROL OPTIONS (SV13.OPT) 
FIELD BIT DEFINITIONS (Continued) 


See ee ee 


APU CONTROL 


DESCRIPTION 


Stops execution of 
the current task 
on the specified 
APU, saves the 
task context, and 
reschedules the 
current task 

to the rear of the 
APU ready queue. 
APU is left in 
IDLE state. 


Select the task 
specified in the 
buffer from the 
APU ready queue as 
the next task for 
the APU to run. 
Tasks appearing in 
the APU ready 
queue after this 
task will execute 
in order. 


Send the APU 
command specified 
in the SVC 
directive option 
field (SV13.DOP) 
to the specified 
APU. 


PREREQUISITES 


APU must be 


enabled. 


APU must have a 
currently exe- 
cuting task. 


APU must be. 


enabled. 


ee i a ee ee 


ee ee ee ee EL 


See Table 3-7. 


ee ee ee eee ee ee sd ee es ee ee 


Reserved for 
future use. 


APU must be in 
OFF state. 


Disable the 
specified APU. 


Task gives up con- 
trol rights to the 
specified APU. 


ee en ee een ene te ed tt ettenttiemlmeend 


| 

! 

' PRIVILEGE BIT HEX 

} OPTION {| POSITION } CODE 
] 

1 

i Stop and i 2 ; x'20° 
{| preempt ' : 

| APU task { { 

! H i 

| 

i] ( i] 

i] ( i] 

H H H 

H i H 

i j H 

\ 

j Select next } 3 | xX'10' 
i task H { 

H { H 

i H H 

‘] t 4 

t i] ' 

H i H 

H H H 

1 i i] 

i] 1 i] 

H i H 

H 

i; Send APU { 4 ; x'O8! 
{ Command ; i 

' H H 

i] t ( 

' 1 i] 

H H 1 

H H H 

i i H 

' 

i Reserved H 5 | x'O4' 
H H H 

! 

i Disable APU } 6 ; X¥'O2' 
H i i 

H 

{| Release ‘ 7 ; x'oOLl’ 
! control H H 

{ rights H H 
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TABLE 3-7 SVC 13 CODE 3 APU COMMANDS (SV13.DOP) 


CO ee a ee ee ee ee ee eee ee se ee ee Se Se 


} CODE j| MEAN ING PREREQUISITES 


i 
i Freer Srsst Beet ste Se Besser EVV STE RTFEseSstFtEBSEPSSSSsSBSsSSsss ss Ss SST sSesesCSSssrstPstsSs STS BSS SSS 
X'O1l' {| Start APU for task execution. ; APU must be in IDLE state. 
i APU enters running state. i 


H 

; X'O2' | Execute single instruction. ; APU must be in IDLE state. } 
4 { { ‘ 
' J ' ' 
i i | Reserved for diagnostic H 
; use. i 
De a aS Sea er Ase ae nee eee eee i 
| X'04°" | Transfer current task to CPU ; APU must be in IDLE state. | 
H i Not recommended for user- H H 
H i written tasks. See SVC 6 i} APU must have a current ' 
H } example in Chapter 6. ; task. i 
(eS SS tS e eS a a eee ea Se re a eee ee Se eS i 
X'O7' {| Start APU for nontask i APU must be in IDLE state. } 

i execution - loads and starts jj} H 

} APU using power fail image. } Reserved for diagnostic | 

H ; use. 

bre Se kee ete OE Sogn ee eae k erg ed Ae are Aae ne RS MS CORAM ae CEE PCS pf pe LN gD eg Rey eae Eg gee eee i 
i; X'O8' {| Store power fail image ; APU must be in IDLE state. } 
( { { t 
! 1 i] ' 
H i | Reserved for diagnostic H 
i i ; use. 
(eS See SS SSeS ee he ee rae Sa ae SaaS ee eee i 
i X'OB' {| Stop APU if task state - {| APU must be running in H 
H } saves context of current { task state (PSW 15=0). H 
H j executing task and stops APU jj} H 
H { (APU enters IDLE state.) {| APU must have a current H 
{ ! { : 
' 1 ;} task. i 
[Sea SS ee SSeS Sere See SSS ee a ae eee eee ea ee ae See eee i 
i; X'80° ; RTSM link check - sends data ;.APU must be in IDLE state. | 
H i byte and receives complement. {| H 
H i . } Reserved for diagnostic H 
i i ; use. H 
a a a a a a a aa 
i X'83° | Reschedules task on APU - } APU must have a current H 
i i reschedules the current task ; task. H 
H } to the rear of the APU ready |} H 
i i queue. ; APU must be in IDLE state. | 


NOTE 
The preferred method of rescheduling a task on an 


APU is to issue an SVC 13 code 3 with the X'20' APU 
control option specified. 


48-040 FOO RO2 3-49 


TABLE 3-7 SVC 13 CODE 3 APU COMMANDS (SV13.DOP) (Continued) 


een ee ee ee ee ee ee Te tii 


HEX | 
| CODE | MEAN ING H PREREQUISITES 
i Sesser srSs SSeS SES SS SeSsetesseeSssrttIoBFStSTEZSBBEEEBPSBAZBEBASEASTAASSASEAKCEEBLESEEBSEDTED SSS az = 
{ X'85' | Stop APU and save power fail | Use only after attempt to 
| } image saves context of } stop APU with X'OB' has 
H | currently executing task and ; failed due to APU command 
} |} Stops APU (APU enters IDLE { sequence error. 
H i state). i 
} came ee cee em ee ee eee ee cee em ee ne cae ee ee ee ee oe cee ee nee eee ne ee eee ee ee cee ee ee ee ee ee em 
i X'86° { Fetches APU status | APU must not be disabled 
[ee ee ee ee nn ee ne ee ee 
| X'89° {| Fetch APU error code | Reserved for diagnostic 
i } use. 
H en ee ee 
; X'8A' | Checkpoint task state saves } APU must have a current 
} | context of current task. |} task. 
H |} Task continues execution if H 
i | previously running or remains } 
H | idle if previously idle. i 
NOTE 
If an undefined command code in the 


SV13.DOP field is to be sent to the APU, 
the APU will identify the code sent as an 
unrecognizable command code or as a 
sequence error. For more information on 
the SVC 13 APU commands, see the Model 
3200MPS Syerem Instruction Set Reference 
Manual. 


3.9.5 SvC 13 Auxiliary eee Unit (APU) Hardware Status 
(SV13.APS) Field 


After execution of SVC 13 code 1 or SVC 13 code 3 option xX'O8', 
the status of the APU hardware is saved in the APU status 
(SV13.APS) field of the parameter block. This field consists of 
two bytes, a response byte and an error code byte, representing 
the response and error fields of the PSW. The hardware status is 
returned to this field in the format shown in Figure 3-20. See 
Table 3-8 for the response byte bit definitions. Error codes 
returned to the error code byte are listed in Table 3-9. See the 
Model 3200MPS System Instruction Set Reference Manual for more 
information. 
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RESPONSE BYTE ERROR CODE BYTE 


es es es ee cm FE vee ee eee ee om ee a ee CO ee ES ee ee ee ee ire ome oe ane ee ie i i ee ee 


i P| Rj iwi Ri EE; Mi M j 

i NON- ;} Ai Ei Ri OTE OTH 

1 Ay Uf i; I} Sj; Ri Di D 4} ERROR H CODE 

} TASK {| T} P}Ojd21j 24 

i; Rj N | i R | i 

Bits: 

0 7 8 15 
Figure 3-20 APU Hardware Response Byte (SV13.APS) 

TABLE 3-8 APU HARDWARE RESPONSE BYTE BIT DEFINITIONS 

i BIT } 

i} POSITION ;} BIT NAME BIT SETTING AND MEANING 


l= ensures that the response byte has 
an odd parity 

O= odd number of bits have been set for 
the remainder of the byte 


: 


RUN i l= APU is running 
{| O= APU is idle 
NONTASK {| 1= current PSW bit 15 is set, indicat- 
j ing no context save area is 
i available 
| O= APU executing in task state; the 
{ 
! 


current PSW bit 15 is not set, 
indicating that the current task's 
context save area is ready to 
receive the processor task state 


ee ee 


i} l= current PSW bit 16 is set, indicat- 
} ing APU is in a wait state or APU is 
j working in an internal service state 
(e.g., scheduling a task) 

{; O= current PSW bit 16 is not set, 

i indicating the APU is executing 

i instructions 


} l= APU is responding to a command from 
1 the CPU 

; O= APU is generating a signal indi- 

H cating a change in APU state 
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TABLE 3-8 APU HARDWARE RESPONSE BYTE BIT DEFINITIONS 


BIT SETTING AND MEANING 


(Cont inued ) 
i BIT 
i POSITION {| BIT NAME |} 
| 5 | ERROR H 
i 
i APU 
{ 
' 
6,7 MOD1 
MOD2 depend 
ERROR, 


l= APU detects an error condition that 


condition is indicated by the set- 
ting of the error code bit (see 
Table 3-9) 

O= no error condition is detected by 


i 
| 
causes the APU to stop; the error i 
H 


Bit definitions for MOD1 and MOD2 


1 


= 


f 


td 


Ld 


f 


on the definitions for RESP and 
as follows: 


ERROR=0 


undef ined 

APU entering queue wait state 
task rescheduled to APU ready 
queue 

task rescheduled to CPU 


ERROR=1 


H 

i 

i 

{ 

' 

{ 

i 

j 

H 

{ 

' 

i 

{ 

{ 

’ 
general error status i 
error occurred while APU in i 
queue wait state i 
error occurred while locking i 
queue 
undef ined H 
{ 

, 

i 

i 

i 

H 

H 

i 

| 

H 

i 

‘ 

! 

{ 

' 


ERROR=0 


general response status 

task is waiting on APU queue 
APU attempting to lock a queue 
command sequence error; command 
was ignored 


ERROR=1 


error as a result of command 
response, error in queue wait 
response, error in queue lock 
error and command sequence error 


48-040 FOO RO2 


See 


NOTE 


the Model 3200MPS System Instruction 


Set Reference Manual for more information 


on 


the nontask . and wait states that 


reflect the PSW bit definitions. 


TABLE 3-9 ERROR CODES FOR ERROR CODE BYTE OF APU 


ee ee Bette nant nnedien time! 


i I eel 
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HARDWARE STATUS (SV13.APS) FIELD 


No error 

APUID DEVICE FALSE SYNC 

ZERO APUID RETURNED BY RTSM 
CAN'T FETCH WORD @ X'C4‘* —- ECC 


APUID > MAX APU @ X'C7' 

BAD A(APB_DIR) - ECC/ZERO/ALIGN 
BAD A(APB) - ECC/ZERO/ALIGN 

BAD APB (FLAGS:APB#) WORD - ECC 


WRONG APB¥ IN APB 

APB PASSBACK 

UNRECOGNIZED COMMAND 

BAD APB A(CTCB) - ECC/ZERO/ALIGN 


BAD A (APU QUEUE) - ECC/ZERO/ALIGN 
QUEUE LOCK TIMEOUT 

EXECUTION SUSPENDED (TRAP PSW WAIT) 
BAD SSTD - ECC 


CAN'T LOAD TASK CONTEXT 
CAN'T STORE TASK CONTEXT 
CAN'T LOAD PWR FAIL IMAGE 
CAN'T STORE POWER FAIL IMAGE 


CAN'T LOAD PSTD - ECC 

BAD APB PFAIL PTR - ECC/ZERO 

BAD APB MMF NEW PSW - PCC/ZERO 
BAD CTCB CTX PTR - ECC/ZERO/ALIGN 


BAD APB TCB CNT WORK - ECC 

BAD A(APU FRONT TCB) - ECC/ZERO/ALIGN 
FRONT TCB PTR< TCB CNT DISAGREE 

QUEUE TCB CNT UNDERFLOW 


BAD APB A(CPU QUEUE) - ECC/ZERO/ALIGN 
BAD TCB QHPTR - ECC/ZERO/ALIGN 
INCORRECT TCB QUEUE HEAD PTR 

BAD TCB BPTR - ECC/ZERO/ALIGN 


awe ren eee we eee eee eee eee eee ew eee ewe ee wee ee 


TABLE 3-9 ERROR CODES FOR ERROR CODE BYTE OF APU 
HARDWARE STATUS (SV13.APS) FIELD 
(Cont inued) 


Canetti eet a ee ee oe eh i ee 


| ERROR | 
| CODE | MEAN ING 
| pawn en esnancaseenesesenessesessseeeeenseesesssen=| 
{ X'20' {| BAD BACK TCB FPTR - ECC/ZERO/ALIGN 
| X'AL' {| BACK TCB FPTR NOT TO FRONT TCB 
| X'A2' | BAD FRONT TCB FPTR - ECC/ZERO/ALIGN 
| X'23' | BAD FWD TCB BPTR - ECC/ZERO/ALIGN 
| X'A4' | FWD TCB BPTR NOT TO FRONT TCB 
{ X'25' | INCONSISTENT FRONT TCB FPTR & BPTR 
| X'26' | BAD FRONT TCB PTR - ECC/ZERO/ALIGN 
| X'A7' | BAD BACK TCB FPTR - ECC/ZERO/ALIGN 
{ { { 
’ ' ' 
| X'A8' | BACK TCB'S FPTR NOT TO FRONT TCB 
| X'29' | TCB QUEUE OVERFLOW (CPU OR APU) 
| X'2A' | BAD MSH TIME ACCUMULATOR - ECC 
| X'AB' {| BAD LSH TIME ACCUMULATOR - ECC 
{ 8 { 
1 ' ' 
{ X'2C' | BAD TCB START TIME WORD - ECC 
| X'AD' {| CAN'T READ RTSM CLOCK DATA 
| X'AE' | TCB ELAPSED TIME OVERFLOW 
| X'2F' | TCB "PENDING" FLAGS SET ON QUEUE OR CTCB | 
| [ { 
' ' ' 
| X'BO' {| BAD "PENDING" FLAGS WORD - ECC 
| X'31' | INTERRUPT FROM RTSM XMTR 
| X'32' | CAN'T LOAD PFAIL PSTD - ECC 
| X'B3' | CAN'T LOAD PFAIL PSTD - ECC 
| X'B4' {| BAD APB MSH TIME ACC - ECC 
| X'B5' | BAD APB LSH TIME ACC - ECC 
| X'B6' | WRONG APU NUMBER IN SBC 'FLAGS' WORD 


On Ne ee ee ee ee es ee ee 


3.9.6 SVC 13 Error Status Code (SV13.ERR) Field 


When execution of an SVC 13 is completed, the execution status is 
returned to the error status code (SV13.ERR) field of the 
parameter block. If no error occurs, a value of O is stored in 
this field. If SVC 13 code 2 or code 3 is issued and an_ error 
occurs, the first byte of this field contains the bit position of 
the option that caused the error. 


Table 3-10 lists the SVC 13 error status codes and their 
applicable function codes. 
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TABLE 3-10 SVC 13 ERROR STATUS CODES (SV13.ERR) 


|} APPLICABLE | 

} STATUS {| FUNCTION } 

} CODE } CODES H MEAN ING 

i sna SS SS SS SV SS SSS SSS SS ST SS SE SS SS SSS SSS STS SS SSS SS SS SS SST ST STS SS 

0 all | No errors occurred. 

| iss “Om “ay ul San) ie es uk sya sfc “is see sen tom ce es Ss Vaasa “eS cc sy Sas a a ce as 

1 H all } The specified data buffer does 

} } not begin on a fullword boun- 

{ dary. 

| fee ce cen creat ancy ee cess cme mh sam ets eyes aye mee eee ee ca ee ee es cee coe me em om em oon om 

2 0,1 i The specified data buffer is 

H H } not located in a writable seg- 

i H i ment of the task. 

i fare me ee came ms mre meee mm cum mm cams em me tas ee ma ee mem cee we wm Se ee en cee ee oe wre ee ce ee “i i es ca ee ese 

H 3 i all } Insufficient space was avail- 

1 } able in the supplied data buf- 

| | fer. For functions O and l, 

| i ij any data that does not fit in 
| i the available space is lost. 

| som ce cement Sah mb Am cee mm em mom a mam ms em me ant ene ets es ee ee me mem a ee mee ee ee me eee ec 

4 H 2,3 i} Task establishment options 

H i prohibit the task from gaining 

1 H {| Mapping or control rights. 

| cee ee eee me ae ee ee ee ee ee ee ee ee ee ee oe ee Se ano a ap a 

H 5 H 2,3 i} Task has not been granted the 

| H } rights to perform the attempt-— 

{ ed mapping or control 

i H | function. 

 itonalenateastoastastinestneatentmeiaatashentantantententantententetetenteatentententen ti i et ek nS Se a emt Sa cea ans Freer in sh Cs 

6 } be ere i The APU number specified is 

H H } greater than the maximum 

H 1 } allowed. 

1 sore meme me nee seme rm cme Pues rsa mre ne rw mm ests hs se me nes ee me ry ee ee ee ee ee ee ee 

7 | 2 option {| The LPU number specified is 

; X*10' } greater than the maximum 

H } allowed. 

H cain a slums Nu “ces n/n nes th, aes a messi cc Semas<misn! ins Ma  cais“as masaYn soySos “aes s Yc ' e er 

H 8 1 23 } An invalid option was speci- 

H i} fied for this function. 

\ i ss meV fe nm a om a a a as: Saas ss a asp se ce Ar a “amas sj a Ne eS va 

9 2,3 | The requested privilege is 

H H } currently held by another 

} task and cannot be granted. 

{ Sm a mms cra. sm na ne em ca“ in: so “ep Vem gi hs. ye Sa nl ic i | jc | Sed, 

10 } 2 option | The specified APU cannot be 

1 X'40° } marked on exclusive from ON 

i 
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state. 


TABLE 3-10 SVC 13 ERROR STATUS CODES (SV13.ERR) 


ready queue. 
unchanged. 


The APU queue is 
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(Cont inued) 
| APPLICABLE j; H 
STATUS {| FUNCTION } H 
CODE } CODES } MEAN ING { 
SS SS Ser Seer Sess SSS SSH SSS SSS SSS SSS SS SS SES SSS SBS SS SS SSeS SS sess i 
11 2,3 | The function requested cannot | 
i be completed because the spe- | 
j} cified APU is in DISABLED 
H } state. | 
Fi 5 a ky a a ES a a ce a i aa lk as SS la cas i St ec) a se | 
12 1,2,3 | Access to the task queue for H 
| | the specified APU could not be |} 
i} obtained; SVC 13 request was 
} |} aborted. H 
ca me ieee sam vom ne cate cae aD ue cam eee MO ee me ee ym eee cme min eee ene eens eve ee cee ee ee ee ee ee ee | 
13 i option |; The task has not been granted | 
} X‘'10' } mapping rights over the APU 1 
} ; currently mapped to the speci- | 
| } fied LPU. 
in sp i ins Sie ik“ ZnS Sr anni > id a's“ men ec a ae a i“ rr ssc Sa "Se i 
14 1 option ; Cannot enable APU unless in H 
} X'40' } DISABLED state. 
Cc tn sas! ah tri i em fe me. “sa tu al i, “Sm as fe a Ver em Sa Es“ “es mm i sp ni em ve i 
15 i option ; APU could not pass power up 
i X'40' |} Link check sequence. APU left } 
H } in DISABLED state. 1 
i a es a a a a ec a a a a ee ate is ee el A aw Sw a ai Sa i eal ss es { 
16 1 option ; Cannot disable APU unless 1 
H X'O2' i in an OFF state. i 
a nn a ye ee ee { 
17 H option .}| The APU could not be marked H 
1 X'40' | on exclusive because the spec- |} 
} } ified task could not be found | 
} i in the system. } 
Se ae go en ee a eee nt ee ne | 
18 H option ; Error encountered in transmis-— |} 
| x'Os' } Sion of the specified control | 
H } command. } 
is i a i iS i ia?‘ ig i | ipl “cm SS i mc“ Sem ark “co Sm ie Sap eS, os fm» ain” | 
19 option The preemptive task could not 
X*'10' be found on the specified APU 


3.9.7 Typical Option Coding Sequences’ for SVC 13 Code 2 and 
Code 3 


The options field (SV13.OPT) in the SVC 13 parameter blocks’ for 
codes 2 and 3 allows the user to issue one call to execute 
multiple APU mapping or control functions. Multiple options are 
executed from left-to-right. Care must be taken when selecting 
the sequence of options to perform a designated APU control or 
mapping procedure. The following sections demonstrate specific 
option coding sequences that would be used by a typical APU 
control task in a Model 3200MPS System. 


3.9.7.1 Auxiliary Processing Unit (APU) Initialization 
and Start Up 


Before a task can run on an APU, the APU must be initialized and 
started for task execution. This is accomplished through an SVC 
13 code 3 with the following sequence of option codes specified: 


OPTION 

CODES FUNCTIONS PERFORMED 

xX'80' Gain control rights for task 

X'40' Enable (initialize) APU 

X'O8' Send APU start directive (X‘'0O1') specified 
in SV13.DOP field 

X'Ol' Release control rights 


3.9.7.2 Auxiliary Processing Unit (APU) Mark On 


After initialization, the APU must be mapped into the LPMT and } 
assigned to the LPU number to which the task that will run on the 
APU is directed. This is accomplished through an SVC 13 code 2 
with the following sequence of option codes specified: 


OPTION 

CODES FUNCTIONS PERFORMED 

X'80' Gain mapping rights for task 
X'20' Mark APU on 

X'10' Map APU into LPMT 

X'OL' Release mapping rights 


The SV13.DOP field contains the LPU number to which the specified |} 
APU (SV13.APN) is to be mapped. i 
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If the APU is to be marked on exclusively for one task, the 
following option coding sequence is used for SVC 13 code 2: 


OPTION 

CODES FUNCTIONS PERFORMED 

X'80' Gain mapping rights for task 
X'40' Mark APU on, exclusive 

X‘'10' Map APU into LPMT 

X'OL' Release mapping rights 


The buffer, identified by the address specified in the SV13.BUF 
parameter block field, contains the name of the task for which 
exclusive access is requested. SV13.DOP contains the LPU number 
to which the specified APU (SV13.APN) is to be mapped. 


3.9.7.3 Effective Task Scheduling on the Auxiliary Processing 
Unit (APU) Queue 


Scheduling is initially done by the task manager; the preempting 
process changes normal scheduling of tasks on an APU. Two 
methods are available for preemptive scheduling of the next ready 
task on the APU ready queue: 


@e Stop the APU, reschedule the currently active task to the rear 
of the queue, and restart the APU, which will automatically 
select the next task from the front of the queue. 


e Stop the APU, reschedule the currently active task to the rear 
of the queue, assign another task on the queue to the front of 
the queue, and start the APU, which will automatically select 
it as the next task to execute. 


To schedule the current task to the rear of the queue, use SVC 13 
code 3 with the following sequence of option codes specified: 


OPTION 

CODES FUNCTIONS PERFORMED 

X'80' Gain control rights for task 

X'20' Stop APU task execution and reschedule current 


task to rear of the queue 
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X'O8' Send APU start directive (X'O1') specified in 
. SV13.DOP field to select the task at the front 
of the APU ready queue for execution 


X'O1' Release control rights 
To preempt the next ready task, thereby explicitly selecting the 


next task to be run, use SVC 13 code 3 with the following 
sequence of option codes specified: 


OPTION 

CODES FUNCTIONS PERFORMED 

X'80' Gain control rights for task 

X'20' Stop APU task execution and reschedule current task 
to rear of the queue 

X'10' Change front of queue pointer to designated task 
(name of task is specified in the buffer identified 
by the address in the SV13.BUF field) 

X'O8' Send APU start directive (X'01') specified in 
SV13.DOP field to start task 

X'O1' Release control rights 


3.9.7.4 Auxiliary Processing Unit (APU) Mark Off 


An APU can be marked off with or without changing its LPU to APU 
mapping assignments in the LPMT. To mark off an APU, use SVC 13 code 
2 with the following sequence of option codes specified: 


OPTION 

CODES FUNCTIONS PERFORMED 

X'80' Gain mapping rights for task 
X'O2' Mark APU off 

X'Ol1' Release mapping rights 
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To mark off an APU and remove all of its references from the LPMT 
(i.e., remap 
SVC 13 code 2 with the following sequence of option codes specified: 


OPTION 
CODES 


X'80' 


X'O8' 


X'0O2' 


X'O1' 


all LPUs currently assigned to the APU to the CPU), use 


FUNCTIONS PERFORMED 
Gain mapping rights for task 


Remove all references to APU number from LPMT, no 
matter what LPUs are assigned to it 


Mark APU off 


Release mapping rights 
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CHAPTER 4 
SUPERVISOR CALL (SVC) INTERCEPTION 


4.1 INTRODUCTION 


SvC interception software is used to write programs that can 
emulate the SVC processing ability of OS/32. This software 
consists of macros that allow a task (intercepting task) to 
intercept the SVC of another task before it goes to the operating 
system for processing. Once intercepted, the SVC can be 
monitored by the intercepting task and sent to the operating 
system for processing, or it can be processed by the intercepting 
task. Table 4-] lists the system macros used for SVC 
interception. 


TABLE 4-1 SYSTEM MACROS FOR SVC INTERCEPTION 


MACRO} FUNCTION 


macros and branches execution to specific error 
routines within the intercepting task. 


} ICREATE | Creates an SVC intercept path. 1 
1 { { 
' 1 I 
| TREMOVE j; Removes a previously created path. 1 
{ i { 
} i ' 
| IGET } Gets data from a data area of the task that issued } 
} an intercepted SVC. H 
[ { { 
' ’ ’ 
} IPUT | Puts data into a data area of the task that issued | 
} { an intercepted SVC. } 
} ICONT | Continues standard execution of an intercepted SVC j; 
H i by passing control to an OS/32 SVC executor. 1 
{ 1 [ 
’ ! ' 
;} IPROCEED } Allows the task that issued the intercepted SVC to |} 
| {| proceed with its execution. 
{ 1 { 
' ! ’ 
} TROLL ; Makes an intercepted task rollable. H 
{ ( ' 
' t ' 
} ITERM | Terminates an intercepted SVC after processing. 
{ { { 
’ t ' 
} ITRAP | Sends a task queue trap to a task. } 
} ITERRTST | Evaluates errors returned by any of the above 1 
( i) i) 
! ! ! 
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The intercepting task tells the OS/32 SVC executor which SVC it 
will process or monitor. When the intercepting task is sent an 
SVC from the executor, the intercepting task handles’ the 
intercepted SVC while the task that issued the SVC is placed in 
a wait state. While executing the intercepted SVC, the 
intercepting task can read from or write to the address space of 
the task that issued the SVC. 


A task is not aware that its SVC has been intercepted unless it 
is informed by the intercepting task. 


SVC interception software must be configured in OS/32 at the time 
of system generation (sysgen). See the INTERCEPT configuration 
statement in the 0OS/32 System Generation (SYSGEN/32) Reference 
Manual. 


A task can intercept SVC calls only after it is linked with the 
intercept task option enabled (OPTION INTERCEPT). See the 0S/32 
Link Reference Manual. The task can then be programmed to 
intercept any of the following SVCs issued by any application 
task in the system: 


e sve l 


e SVC 2 code 7 


e svc 3 
e svc 6 
e svc 7 


Intercepting tasks can be loaded and executed under MTM. 
However, the intercepting task must be loaded from an account 
that has executive task (e-task) load privileges. See the 0S/32 
Multi-Terminal Monitor (MTM) System Planning and Operation 
Reference Manual. 
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4.2 HOW SUPERVISOR CALL (SVC) INTERCEPTION WORKS 


In general, SVC interception software functions as follows: 


ie 


A task with SVC interception enabled by Link is built. This 
intercepting task must: 


An 


If 
of 


If 


reserve memory for a set of request descriptor block (RDB) 
buffers for each SVC to be intercepted, 


build a circular list for storing addresses of RDB buffers 
containing information on intercepted SVCs, 


create (via the ICREATE macro) intercept paths that 
designate the SVCs to be intercepted, and 


define (via the ICREATE macro) what control the 
intercepting task has over the SVCs it intercepts. 
application task issues an SVC. 


no intercept path was created for that particular SVC, one 
the standard OS/32 executors services the SVC. 


an intercept path has been created for that SVC, the 


operating system: 


intercepts the SVC before it reaches the O0S/32 executor, 


removes an RDB address from the circular list of the 
intercepting task, 


loads the SVC's parameter block and identifying 
information into the RDB, and 


sends a task event trap to the intercepting task to notify 
the task that an SVC has been intercepted. 
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5. Execution of the intercepting task branches to the task event 
trap handling routine. The address of this routine is 
specified when the path is created via the ICREATE macro. 


6. If the intercept path was built to monitor this SVC, the task 
event trap handling routine issues an ICONT macro to return 
the SVC to the OS/32 executor for execution. 


7. j..I£€ the intercept path was built to service the SVC, the task 
event trap handling routine processes the SVC by the 
intercept macros IGET, IPUT, IROLL, and ITRAP. Also, the 
routine can issue the IPROCEED macro to allow the application 
task to continue executing during SVC processing. 


8. After the task event trap handling routine processes the SVC, 
it issues an ITERM macro that transfers control back to the 
application task that issued the SVC. 


9. The intercepting task exits the trap handler through the 
TEXIT macro. 


4.3 PREPARING A TASK FOR SUPERVISOR CALL (SVC) INTERCEPTION 


Before creating an intercept path, an intercepting task must: 


@ build a set of RDB buffers for each type of SVC to be 
intercepted, 


e build a circular list to store the addresses of the RDB 
buffers, and 


@e be prepared to handle a task event trap. 


4.3.1 Request Descriptor Block (RDB) Buffers 


The size of each RDB buffer built by the intercepting task 
depends on the size of the parameter block for the particular SVC 
that is to be intercepted. For example, a set of buffers 
allocated for SVC 6 interception will be larger than ae eset of 
buffers for SVC 1 interception. When an intercepting task uses 
one set of buffers for intercepting two or more SVC types, the 
buffer size must equal the size of the RDB needed to hold the 
largest parameter block associated with the SVCs to be 
intercepted. Figure 4-1 shows the RDB fields. To define a 
structure containing these fields, use the $RDB macro. 
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Ce A ee A A dd ee eee ee es ee ee 


i2(02) Intercept path 


i] 

i) 
H Reserved H identifier H 
H (RDB.RID) H CROP: PID) H 
(Sees arene ee eee ee ee ee ae Oe H 
14(04) Parameter block offset |{|6(06) SVC {7(07) “Pak { 
H (RDB .OFF ) H type H priority | 
{ ' (RDB.SVC) i (RDB. TERI) ; 
fr ere rt rem een san H 
18 (08) ! 
{ Operating system task identifier 
H (RDB.TID) H 
| ss ew sm sim: mrss u/s oe Sisal <a owt “rs iw ml ms” esl -at “ msa “tm win“ x Sems c “e “e es ar acs Dsecees came en nc { 
| 12(0C) | 
H SVC parameter block address H 
(RDB. PAD) | 
| cia’ etm Sein en’ in a Co: teal die’ ai as gm min’ Pam musi elms ce “es “amis i es. wr eee cm. ei Scns" lig SS “> ease eA is se H 
1 16(10) Fie cuctaon address following H 
H intercepted SVC instruction { 
i (RDB.SVAD) H 
[SSeS SSS SSeS eee ae Se ee Se ee ee a oe eee eee Se eee H 
120(14) 


es 


SVC parameter block 
(RDB. PB) 


° 


Figure 4-1 Request Descriptor Block 


The fields contained within the RDB are described as follows. 


Fields: 


Reserved 
(RDB.RID) 


Intercept 
path 
identifier 
(RDB .PID) 


Parameter 
block 
offset 
(RDB.OFF ) 
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is a halfword field reserved for future use. 


is a halfword field containing an SVC 
intercept path identifier exclusively reserved 
for one particular SVC interception. 


is a halfword field containing the hexadecimal 
offset value for the parameter block field 
within the RDB. 


list to 


circular 
Refer to 
User's 

circular list. 


svc 


type 
(RDB .SVC) 


Task 
priority 
(RDB.TPRI) 


Operating 
system task 
identifier 
(RDB.TID) 


SVC parameter 
block address 
(RDB. PAD) 


Instruction 
address 
following 
intercepted 
SVC 
instruction 
(RDB .SVAD) 


SVC parameter 
block 
(RDB.PB) 


The intercepting task must have a standard Perkin-Elmer 
hold the address of each RDB buffer. 
the fields of the standard circular list. 
the intercepting task for processing, one RDB buffer 
automatically 
filled with information identifying the 
list can be created by the assembler instruction DLIST. 
appropriate 
for 


the 
Manual 


removed 


is a l-byte field containing a decimal number 


specifying the type of SVC that is to be 
intercepted. 

e O01 indicates SVC l 

@e 02 indicates SVC 2 code 7 

e 03 indicates SVC 3 

e 06 indicates SVC 6 

e O7 indicates SVC 7 

is a l-byte field containing a decimal number 
specifying the priority of the task that 
issued the intercepted SVC. 

is a 4-byte field containing the operating 
system task identifier for the task that 


issued the intercepted SVC. 


is a 4-byte field containing a hexadecimal 
number specifying the address of the parameter 
block for the SVC being intercepted. For 
SVC 3 interceptions, this field contains’ the 
end of task code. 

is a 4-byte field containing a hexadecimal 
number specifying the address of the instruc- 
tion following the intercepted SVC 
instruction. This field is set to 0 for SVC 
3 interceptions. 


is avariable length field containing the 
parameter block of the intercepted SVC. 


4.3.2 Circular List for Request Descriptor Block (RDB) Buffers 


circular 
Figure 4-2 shows 
When an SVC is sent to 
address’. is 
and the RDB is 
The 


from the circular list, 


intercepted SVC. 


Perkin-Elmer Series 3200 Processor 
a more detailed explanation of the standard 
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H of buffers | of buffer i 
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14(04) i'6(06) 
H Current top { Next bottom H 
{ § { 
Gea se Asis at ee rts erg eg see es eae ts tec 
1 i] 
18(08) 
H A (buffer 1) 1 
H 
H eect sos mas wees! sou cas cs) scams emcees Seep tes “u >is as smi sr‘ mins sis tem onset pad Senso a sti see" sa eels wan omen we Sukarno 
12(0C) 


ee ee 


I i eae) 


Ce ee ee ied aaa atedtactinnlc tatiana 


» 
~~ 
oy 
c 
rh 
mh 
) 
ni 
2) 


a i cn Mi eh cee are ne i ee te tee eee ce martimen eencnn tie Eee ie adie cenedieelaeatieed 


Figure 4-2 System Task Buffer List (Standard Circular List) 


Fields: 


Max imum 
number of 
buffers 


Current 
number of 
buffers 


Current top 


Next bottom 


A (buffer n) 
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is ahalfword field indicating the maximum 
number of fullwords in the entire list. 


is a halfword field indicating the number of 
fullwords currently in use. When this’ field 
equals 0, the list is empty. When this field 
equals the number of fullwords in the list, 
the list is full. 


is a halfword field indicating the address of 
the RDB buffer that is currently at the top of 
the list. 


is a halfword field indicating the address of 
the next RDB buffer that is at the bottom of 
the list. 


indicates the address of an RDB buffer. 


4.3.3 Task Event Trap 


To receive a task event trap, an intercepting task must have the 
TSW.TESB bit in its task status word (TSW) set. See the 0S/32 
Application Level Programmer Reference Manual for more 
information on TSW bit settings. If this bit is not set, the 
task event trap will be queued until a TSW is loaded with this 
bit set. In addition, a task cannot receive a task event trap or 
task queue trap during execution of the task event trap handling 
routine. These traps will be queued until the task exits from 
the routine. 


Before execution branches to the task event trap handling 
routine, the operating system places the address of the RDB in 
register 1 and a unique intercept path identifier in register 0. 
To prevent the data in these registers from being lost during 
execution of the task event trap handling routine, the 
intercepting task should be link edited with the TEQSAVE task 
option. TEQSAVE informs the operating system which register 
contents should be saved and restored when a task enters or exits 
the task event trap handling routine. See the 0OS/32 Link 
Reference Manual for more information on TEQSAVE. 


4.4 CREATING INTERCEPT PATHS (ICREATE) 


Before an intercepting task can intercept an SVC, it must create 
a path to the application task that contains the SVC to be 
intercepted. This path is created by executing code built by the 
ICREATE macro that informs the OS/32 SVC executor which SVC is to 
be intercepted by this path. The intercepting task also accesses 
the application task's address space through the intercept path. 


An intercept path remains in effect until it is removed by the 
intercepting task creating it or until the intercepting task 
terminates. Although only one type of SVC can be intercepted by 
each path, there is no limit to the number of paths that can be 
created by one intercepting task. 


The mode parameter of the ICREATE macro specifies when an SVC is 
to be intercepted. Under caller mode, the specified SVC is 
intercepted every time it is issued by the application task. 
When the recipient existent mode is specified, the SVC is 
intercepted only when it is directed towards a specified task, 
device, pseudo task, or pseudo device that exists in the system. 
Under the recipient nonexistent mode, the SVC is intercepted only 
when it is directed toward a specified pseudo task or pseudo 
device created by execution of code built by the ICREATE macro. 
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4.5 HOW TO CREATE A PSEUDO DEVICE OR TASK WITH ICREATE 


A pseudo device consists of a name and the SVC 1 or SVC 7 
intercept paths attached to it. The pseudo device name, which is 
known to the system but does not actually refer to any system 
device or file, consists of a device name, filename, and 
extension. A device name that does not already exist for a real 
device or disk volume must be used. Pseudo devices’ ignore’ the 
file class/account number field of the file descriptor. 


When the operating system cannot find a device or filename in the 
system, it will search the list of pseudo devices. If a match 
occurs, the system will continue processing the SVC using the 
pseudo device. 


To create a pseudo device using SVC interception software, the 
ICREATE macro should be set to specify either an SVC 1 or SVC 7. 
The recipient nonexistent mode should also be specified. An SVC 
l intercept path must be in effect when an I/O operation is 
attempted to a pseudo device; otherwise, an invalid function 
(X'CO') error status is returned. 


A pseudo task consists of a name attached to one or more SVC 6 
intercept paths. A pseudo task name is known to the system but 
does not refer to an actual task existing in the system. 


To create a pseudo task, issue the ICREATE macro specifying SVC 
6 and the recipient nonexistent mode. Because a pseudo task does 
not refer to a real task, the pseudo task cannot be cancelled. 
Both pseudo tasks and pseudo devices can be deleted by removing 
all intercept paths attached to them. 


4.6 USE OF GENERIC NAMING FOR PSEUDO DEVICES AND TASKS 

A pseudo device or task can be generically named. The following 
characters can be used for generic naming: 

e An asterisk (*) represents any character or blank. 

e A backward slash (\) represents any character. 

If a pseudo device or task name specifies the filename and 
extension fields as blanks, the system substitutes filename and 
extension fields filled with asterisks. This has the effect of 


generically naming the filename and extension fields so that they 
will always match the input filename and extension. 
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If the operands of an ICREATE macro. specify the recipient 
existent mode and a generic pseudo device or task name, a pseudo 
device or task must exist with its name exactly matching the one 
specified by ICREATE. An error will result if the names do not 
match. For example, a system is asked to create the following 
pseudo devices: 


@e FAKE:FILE1 

e FAKE:FILE* 

@ FAKE: 

e FAKE:FILE* .EXT 


Normally, the following input will match the above’ pseudo 
devices: 


INPUT NAME SELECTED PSEUDO DEVICE 
FAKE: FAKE: 

FAKE: FIILE3 FAKE : F ILE* 

FAKE: FILEL FAKE: FILE1L 

FAKE: FILE11 FAKE: 

FAKE: FILEX.EXT FAKE :FILE* .EXT 

FAKE: FILEX.EX FAKE: 


When the code built by the ICREATE macro is issued specifying 
recipient nonexistent mode and the pseudo device FAKE:, the 
ICREATE function will not be performed because the pseudo device 
already exists. Consequently, when an ICREATE macro is used 
specifying recipient existent mode along with the pseudo device 
FAKE: FILE*, ICREATE will be executed because the pseudo device 
FAKE: FILE* already exists. 


4.7 FUNCTIONAL SUMMARY OF SUPERVISOR CALL (SVC) INTERCEPTION 
The following describes how interception works for each SVC and 


mode: 


SVC 1 caller Any SVC 1 issued by the specified task is 


intercepted. 
SVC l Any SVC 1 directed to an lu assigned to the 
recipient specified device Or pseudo device is 
existent intercepted. (Note that disk volume 


interception is not supported for SVC l1.) 


SVC 1 The pseudo device is created, and any SVC l 
recipient call specifying an lu assigned to this pseudo 
nonexistent device is intercepted. 


4-10 48-040 FOO RO2 


SVC 2 code 7 
caller 


SVC 2 code 7 
recipient 
existent 


SVC 2 code 7 
recipient 
nonexistent 


SVC 3 caller 


SVC 3 
recipient 
existent 


SVC 3 
recipient 
nonexistent 


SvC 6 caller 


SVC 6 
recipient 
existent 


SVC 6 
recipient 
nonexistent 


SVC 7 caller 


SVC 7 
recipient 
existent 


SVC 7 
recipient 
nonexistent 


Any SVC 2 code 7 issued by the specified task 
is intercepted. 


This call is invalid. 
This call is invalid. 


If the specified task goes to end of task for 
any reason, an SVC 3 intercept will occur. 


This call is invalid. 
This call is invalid. 


Any SVC 6 issued by the 
intercepted. 


specified task is 


Any SVC 6 directed to the 
or pseudo task is intercepted. 


specified task 


The pseudo task is 
call directed to 
intercepted. 


created, 
this 


and any SVC 6 
pseudo task is 


Any SVC 7 issued by the 
intercepted. 


specified task is 


Any SVC 7 directed to the 
disk volume, or pseudo 


specified device, 
device is intercepted. 


The pseudo device is created, and any SVC 7 
call specifying this pseudo device is 
intercepted. 


4.8 FULL AND MONITOR CONTROL INTERCEPT PATHS 


The ICREATE macro 
intercept path 
application task. 


level of control that the 
intercepting task to have over an 


specifies the 
allows an 


A full control intercept path allows the intercepting task to 
exert full control over a task whose SVC has been intercepted. 
Specifically, the intercepting task can: 
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Either ICONT or ITERM can be used to terminate interception from 
a monitor control intercept path. The system does not 
differentiate between the two calls in this case. Here the ICONT 
or ITERM macro replaces the RDB buffer address back on the 
circular list. It is very important that the ICONT or ITERM 
macro be used to replace the RDB. 


Cancelling an application task under monitor or full control 
aborts the processing of the intercepted SVC in progress. The 
intercepting task must still issue an ICONT or ITERM to terminate 
the SVC interception. 


4.11 HOW TO REMOVE INTERCEPT PATHS 


An intercepting task can remove an intercept path by executing 
code built by an IREMOVE macro specifying the path to be removed. 
IREMOVE can be used for both immediate and delayed termination 
depending on whether the controlled shutdown or abort option is 
chosen. 


The controlled shutdown option refuses all incoming requests’ and 
completes the servicing of all existing queued and executing 
SVCs. When processing of the last existing SVC intercepted by 
the path is completed, the path is removed from the system. 


The abort option terminates all existing queued and executing 
SVCs before removing the intercept path from the system. 


4.12 ERROR HANDLING 


Run-time errors that result from executing intercept macro code 
are handled by user written error routines within the 
intercepting task. When an error occurs, execution branches’ to 
the routine specified by either the IERRTST macro statement or 
the error parameter associated with each macro. 


The IERRTST macro is issued immediately after a macro for which 
the error parameter has been omitted. If an error occurs, 
execution of the intercepting task will branch to a user written 
error routine to handle the error. Error codes returned by the 
IERRTST macro are listed in Table 4-2. If no error occurs, 
execution continues at the instruction following the IERRTST 
macro. 


If the ERROR parameter is specified with an intercept macro. and 
an error occurs, execution branches to the specified error 
routine within the intercepting task. If no error occurs, 
execution proceeds to the next executable statement. The error 
routine pointed to by the ERROR parameter can contain an IERRTST 
macro to identify what error has occurred. 
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TABLE 4-2 ERROR CODES RETURNED FOR INTERCEPT MACROS 


Capelli Eamsstitteetiaatataatitenthdicedas ste tiated aetna Eee Eee a i en ee co 


} ERROR } } RELEVANT 
| CODE } MEAN ING { MACROS 

| SSS Se eee SR RE ES ST ES RS SRS SER ESE SES TSS See eS 
i; MO | Invalid aneerceDe ter mode } ICREATE 

\ Sn acm YS 2s “Sl <email sn“ “ein msn sms tam ems te mm nS Ss Cae arm m3 cw ss a, Ca nH wees 
i AD Invalid address in pavanetes con- {| ICREATE 

H } trol block (PCB) | ITERM 

| ICONT 

! TREMOVE 

; ITRAP 

| IGET 

| IPUT 

\ nS et i’ rani: ioc, ores etn’ GA Cane ms i Sef Senne (Slo in Vii a Cat eS em, ‘win tind, ei Sinn Rede ha hn tem hp 
} EX ; Task or device exists when it } ICREA'TE 

i; Should 

H Fm Sars ral a a ta tm ii i ii" i ens Se, ri “Sr "cars, me! cn Sn, Sn on mem ai est rc es a fe we ewe: Sims 
i SP : Insufficient system space to do ;} ICREATE 

1 } request, or NINTC>64, or | I'TERM 

| PBSIZED998 : ITRAP 

i } IGET 

;} IPUT 

i mete ei ni mp re et ee “cay lew cm Geiser rn GN ns ps te kn ec pues ae emo ga cai Na ite ek ia 
i CT i Full control already selected | ICREATE 

{+ IROLL 

| IPROCRED 
| ITRAP 

| IGET 

{ IPUT 

i Sl ea ls ace espe “as ne a ei ony ese Sw al Me ane Mae seh eh a es Ae i Bale sa ea eS eet aS ah, ec am fetes 
; HA } Invalid queue handler name } ICREATE 

\ So Sa A la a at a a a ee ea a es sme oT eg Sc inh cr aoe cae i a Se ea Meee a “wee ees = 
; FD } Invalid device name or task name | ICREATE 

| mee Se ena: Sed sn Sat “en get oss oe pl fess Sa “ane tas natn TSS Saas To i “eb Snes nnd“ SOO Ses Saag: dr tal a ai oe a wid See eS Soe alee ics 
r St i Invalid state for call; e.g., ;} ICONT 

} LROLL followed by ICONT or issuing ;} IREMOVE 

| IPUT with monitor control inter- } TROLL 

{ cept path { IPROCKED 
H 1 | ITRAP 

| IGET 

{ IPUT 

i ei jc mts “ens een bin ema 8 sh ‘scm oy et Ss n/a mcs eS eee ch tS jl Vw“ a vaio psy nS nt "la tl 
| TP | Task queue item not added | ITRAP 

| tne aac, Fels pi eh ap iy a a aa Cau Sa "a ah rte eh anh “Se 
} RD | Invalid RDB } ITERM 

} } ICONT 

1 } + TROLL 

| } } IPROCEED 
} ; ITRAP 

H |} IGET 

1 } IPUT 
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TABLE 4-2 ERROR CODES RETURNED FOR INTERCEPT MACROS 


(Cont inued ) 
| ERROR } | RELEVANT | 
i CODE $ MEAN ING {| MACROS | 
: ID ; Intercept path corresponding to i ITREMOVE H 
; i this path ID ness not exist i H 
oa es aniteaonce or nialicia oA dis aa is aa GES os 
} WR AeeSmpe £6: copy SVC parameter | ITERM H 
| block back into write protected H H 
; area ' H 
H ‘Se’ Sa jus ‘enh ast as¥ rn sas as? iSelect: Stn es tw’? tn Zsa Samim Cave ced cen sabes ame)" sted mas‘ mt cc ss“ mms ei ‘sees Gs el elas Sion ahs coe aes Fase feet H 
H CD | paged subcode in SVC parameter { all { 
\ ' block i { 
} i SVC interception software not in- H i 
H ; cluded at sysgen i i 
aa aaa a a lr ra eas ns ain ae eae } 
i NT H invercented task has gone to end { [TROLL H 
; i; of task | IPROCEED ;| 
i H } ITRAP ' 
1 i i IGET 
i { [PUT 1 


Ree eee eee ne ee ee ee ee es ee ee 


4.13 MACROS USED WITH SUPERVISOR CALL (SVC) INTERCEPTION 


Once configured for SVC interception, the operating system allows 
tasks to execute code built by macros for SVC interception 
provided the tasks were linked with the intercept option. 


This section gives the syntax for the SVC macros described in the 
previous sections. See the OS/32 System Macro Library Reference 
Manual for a list of syntax rules. 

4.13.1 ICREATE Macro 

The ICREATE macro creates an intercept path for a particular SVC 


type. See Table 4-3 for valid combinations for the SVC, MODE, 
and NAME parameters. 
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Format: 
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OPERATION 


ICREATE 


OPERAND 


CL 
,MODE=<RX 
RN 
,NAME=pointer 
,TID=pointer 
le 
, CONTROL= 
MC 
,BUFFERL=pointer 
[ HANDILER=po inter | 
,PID=pointer 
,EXEC=pointer 
[, PBS [ZE=n | 
[: SVAR=po inter | 
[: ERROR=po inter | 


[, PcB=pointer |] 


[: FORM=L | 
[: N INTC=n | 


Parameters: 


SVC= 


MODE= 


is an integer, enclosed by parentheses, that 
indicates the type of intercept path to be 
created: 


e (1) indicates SVC l 

e (2,7) indicates SVC 2 code 7 

e (3) indicates SVC 3 

@ (6) indicates SVC 6 

e@ (7) indicates SVC 7 

indicates one of the following interception 
modes: 

e CL indicates caller mode 

@® RX indicates recipient existent mode 

e RN indicates recipient nonexistent mode 
When CL is specified, an intercept path is 
created for all SVCs (selected by the SVC 
parameter) issued from the task specified in 
the NAME or TID parameter. 

When RX is specified, an intercept path is 
created for all SVCs (selected by the SVC 
parameter) directed to an existing task, 
device, pseudo task, or pseudo device 
specified in the NAME parameter. 

When RN is’ specified, a pseudo device is 
created for SVC 1 or SVC 7, or a pseudo task 
is created for SVC 6. The pseudo device or 
task is attached to the intercept path created 
by the call. 


A pseudo task or pseudo device is deleted when 
all intercept paths attached to it are 


removed. When a pseudo device is assigned 
without SVC 7 interception, the requested 
access privileges are ignored and shared 
read/shared write privileges are granted. If 


an SVC 1 is attempted to a pseudo device 
without an interception in effect, an invalid 
function error (X'CO') is returned. 
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NAME= 


indicates the address of the memory location 
specifying the name of a device, task, pseudo 
device, or pseudo task. This location must. be 
fullword boundary aligned and contain eight 
bytes of blanks followed by a standard file 
descriptor (fd) or task identifier (taskid). 
An fd must be packed, left-justified, and 
padded with blanks within the fullword. A 
taskid must be left-justified and padded with 
blanks. 


When RX or RN is’ specified by the MODE 
parameter, the standard fd or taskid given 


with the NAME parameter can include an 
asterisk or a backward slash to allow generic 
naming. See Section 4.6. 


TABLE 4-3 VALID COMBINATIONS FOR SVC, MODE, AND NAME 


PARAMETERS 


Re ee eee en ene i Mee i i I Ne er 


ICREATE PARAMETERS i 
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| HST SS SoS SES SSS SS SKS TS SSS SSS SSS SS SS SS SS SS SSS SS SS STS SS SSS SS 
taskid Intercepts any SVC 1 issued from the 
task 


! 
NAME= | FUNCTION 


i] 
' 
fd } Intercepts any SVC 1 directed to the 
1 
! 


ee ae 


existing device 


fd Creates a pseudo device and inter- 
cepts any SVC 1 directed to it 

ee ee a ae ee se leaalantansiceieentaatmatanteatmtantimetabenteniedtemtaaieenteadmtaatiatmdamametanenmtaet 
taaKia i Intercepts any SVC 2 code 7 issued H 
} from the task 
as | No function; specifying fd or taskid | 
} results in error 
-— i} Results in error 

taskid End of task inverceeeions occurs no 


1 
! 
i} matter how a task terminates 

lan | No function; specifying fd or taskid 
; results in error 

i} Results in error 


eee ae eee 


TABLE 4-3 VALID COMBINATIONS FOR SVC, MODE, AND NAME 
PARAMETERS (Continued) 


a i Mt ener ee ed ce i ee ee tee ed 


TID= 


CONTROL= 


BUFFERL= 


taskid 


taskid 


taskid 


taskid 
fd 


fd 


ce eee en mm nee ee ee me nem ene peme MSN ee nate ce See es et es ome eee cams mee ees ree et em rem ee mi eee ome SE ee re ecm Ae Sm ata mls SH ree Am ve emi oe 


Intercepts any SVC 6 issued from tHe 
task 

Intercepts any SVC 6 directed to the 
existing task 

Creates a pseudo task and intercepts 
any SVC 6 directed to it 


Intercepts any SVC 7 issued from the 
task 

Intercepts any SVC 7 directed to the 
existing device 

Creates a pseudo device and inter- 
cepts any SVC 7 directed to it 


ene meme mmm me mrs set rem mre ene mm ee ee mem ee cane eee meme me em ee ee ee cee ee ee erm me ree re ee ee ee 


indicates the address of a fullword location 
containing a task identifier. This parameter, 


which 


is mutually exclusive with the NAME= 


parameter, can be used when MODE=CL, or 
MODE=RX with SVC 6, to identify the task to be 
intercepted. The TID can be obtained from the 


RDB .TID 


field of an RDB froma previously 


intercepted SVC call. 


contains a mnemonic indicating either full 


control 


(FC) or monitor control (MC) over 


intercepted SVCs. 


When 
exert 


CONTROL=FC, an intercepting task can 
full control over an application task's 


intercepted SVCs. 


When CONTROL=MC, an intercepting task acts as 
a monitor only; it has no control over an 
intercepted SVC. 


indicates the address of the standard circular 
list that contains the addresses of available 
RDB buffers. 
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HANDL.ER= 


PID= 


EXEC= 


PBSIZE= 
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The RDB used by the intercepting task to 
identify an intercepted SVC must not be moved 
to a new location after the interception takes 
place. The system ensures that the address of 
this RDB is the same as the address of the RDB 
that was passed to the intercepting task when 
the interception occurred. 


indicates the address of a fullword location 
containing the name of a queue handler. This 
name, a maximum of eight characters, is 
left-justified and padded with blanks. If 
this parameter is omitted, the default queue 
handler is invoked. 


NOTE 


Currently, user defined queue 
handlers are not supported. 


indicates the address of a halfword location 
that is used by the system to store the path 
identifier for the intercept path. 


is the address of an SVC intercept executor 
routine within the intercepting task. This 
routine will process intercepted SVCs of the 
type specified with the SVC parameter. During 
SVC interception, the system removes an RDB 


specified by the list, fills it with 
information, and queues a task event trap with 
the specified executor address to the 


intercepting task. 


On entry to an executor routine, general 
register O contains the PID of the intercept 
path and general register 1 contains’ the 
address of the RDB buffer associated with the 
intercepted SVC. The executor routine 
executes as task event service routine. 


specifies the number of bytes in the parameter 
block for the SVC indicated by the SVC 
parameter. 


When this parameter is omitted, the parameter 
block size defaults to the standard sizes 
documented for each type of SVC in the 08/32 
Supervisor Call (SVC) Reference Manual, except 
for SVC 2 code 7 interception, which defaults 
to eight bytes. 


SVAR= 


ERROR= 


PCB= 


FORM= 


NINTC= 


The size of the RDB.PB field in the RDB for 
this interception path is the value of the 
PBSIZE parameter (or its default if PBSIZE is 
not specified). 


is the address of a fullword location 
containing user defined data. This data is 
passed to the intercept logic. The queue 


handler named by the HANDLER parameter can 
later access the data. The SVAR parameter is 
for user defined purposes’ when needed by a 
user defined queue handler. 


NOTE 
Currently, user defined queue 


handlers are not supported. 


is the address of an error routine within the 


intercepting task. If a run-time error occurs 
for this macro, execution branches to this 
error routine. If this parameter is omitted 


and a run-time error occurs, execution resumes 
with the instruction following code built by 
the macro. 


is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. 


When no PCB parameter is included, macro code 
automatically builds a new PCB and initializes 
it with values corresponding to the other 
specified parameters. 


L requests a PCB to be built but not executed. 
Macro code constructs a PCB for this macro and 
initializes it with values. Subsequent macros 
can reference this PCB via the PCB parameter. 


n specifies the number of interceptions’ that 
can be handled concurrently for this intercept 


path. If there are more SVC interceptions 
outstanding than can be handled concurrently, 
the excess interceptions are queued. The 


default value for n is l. 


4.13.2  IREMOVE Macro 


The [REMOVE macro allows an intercepting task to remove one or 
all previously created SVC intercept paths. 
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Format: 


Parameters: 


PID= 


TERM= 


ERROR= 
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OPERATION 


I REMOVE 


OPERAND 


PID=pointer 


CS 
, TERM= 


[: PCB=po inter | 


i ; 

1 ,ERROR=pointer 
i ] 
| |,-FORM=L 

me i 


is the address of the path identifier 
specifying the path being removed. A zero 
value in the PID halfword removes all existing 
intercept paths. 


indicates either of two termination modes’ for 
intercepted SVCs already queued for the 
intercepting task: 


e AB indicates abort. OS/32 aborts all 
currently queued requests before path 
removal. 

e CS indicates controlled shutdown. OS/32 


services only currently queued requests 
before path removal; no requests made after 
TERM=CS is issued can be queued OY 
processed. 


If this parameter is omitted, AB is’ the 
default. 


is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for this macro, execution branches to this 
error routine. If this parameter is omitted 
and a run-time error occurs, execution resumes 
with the instruction following the macro. 


PCB= 


FORM= 


4.13.3 IGET Macro 


is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. 


If this parameter is omitted, a new PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 


L requests a PCB be built but not’ executed. 
A PCB is built by this macro and initialized 
with values. Subsequent macros can reference 
this PCB via the PCB parameter. 


The IGET macro allows an intercepting task to get data from the 
application task whose SVC is intercepted. 


Format: 


OPERATION 


OPERAND 


Parameters: 


RDB= 


ADST= 


RDB=po inter 
,ADST=pointer 
, ADEND=po inter 


,SDST=pointer 


[: ERROR=po inter | 
[,PCB=pointer | 
[: FORM=L | 


i 

i 

i 

$ 

' 

i 

i 

} ,SDEND=pointer 
{ 

4 

! 

} 

[: DONE=adar | 
{ 

' 


is the address of the RDB buffer built for the 
intercepted SVC. 


is the start address of a data area within the 
application task whose SVC is intercepted. 
The contents of this area are transferred to 
an intercepting task data area. 
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ADEND= 


SDST= 


SDEND= 


ERROR= 


PCB= 


FORM= 


DONE= 
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is the end address of the data area within the 
application task whose SVC is intercepted. 


is the start address of a data area within the 
intercepting task. This area receives’ the 
data from the application task. 


is the end address of the data area within the 
intercepting task. 


is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for this macro, execution branches to this 
error routine. 


If this parameter is omitted and a_ run-time 
error occurs, execution resumes with the 
instruction following the macro. 


is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. 


If this parameter is omitted, a mew PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 


L requests a PCB be built but not executed. 
A PCB is buiit for this macro and initialized 
with values. Subsequent macros can reference 
this PCB via the PCB parameter. 


is an address that specifies that the macro is 
to be a PROCEED call. When the call is 
completed, a task event interrupt occurs, 
using the routine specified by the address in 
the DONE parameter. This routine enters with 
RO containing the error code for the call and 
Rl pointing to the macro's parameter block. 
Once this routine has finished processing, it 
exits using the code built by the TEXIT macro. 


The proceed form of the IGET macro must _ be 
used if an [ROLL macro was’ issued to the 
application task whose SVC is’ intercepted. 
The system cannot guarantee that. the 
application task is in memory or that it can 
be rolled into memory within a_ reasonable 
time. 


4.13.4 IPUT Macro 


The IPUT macro lets an intercepting task put data into a data 
area of the application task whose SVC is intercepted. 


Format: 


OPERATION 


OPERAND 


tn NE DN OY ce See DS ES SS es ee Ge SY a ee ee ee ee ee ee UY Gee Ge ee ee eee ee ee ee 


Parameters: 


RDB= 


ADST= 


ADEND= 


SDST= 


SDEND= 


ERROR= 


RDB=po inter 
,ADST=pointer 
, ADEND=po inter 


,oDST=pointer 


[: ERROR=po inter | 
[-PCB=pointer | 


H 

{ 

! 

i 

H 

H 

i 

! 

| 

} »~SDEND=pointer 
{ 

H 

t 

t 

i 

[: FORM=L | 
H 

j 

j 


[: DONE=addr | 


is the address of the RDB buffer built for the 
intercepted SVC. 


is the start address of a data area within the 
application task. This area receives’ the 
contents of an intercepting task data area. 


is the end address of the data area within the 
application task. 


is the start address of a data area within the 
intercepting task. The contents of this area 
are put into the application task data area. 


is the end address of the data within the 
application task. 


is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for code built by this macro, execution 
branches to this error routine. 
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PCB= 


FORM= 


DONE= 


4.13.5  ICONT Macro 


If this parameter is omitted and a run-time 
error occurs, execution resumes with the 
instruction following the macro. 


is the address of a PCB previously constructed 


and initialized by the FORM=L parameter. If 
this parameter is omitted, a new PCB is 
automatically built and initialized with 


values corresponding to the other specified 
parameters. 


L requests a PCB be built but not executed. 
A PCB is built for this macro and initialized 
with values. Subsequent macros can refer to 
this PCB via the PCB parameter. 


is an address that specifies that the macro is 
to be a proceed call. When the call is 
completed, a task event interrupt occurs, 
using the routine specified by the address in 
the DONE parameter. This routine enters with 
general register O containing the error code 
for the call, and general register 1 pointing 
to the macro’'s parameter block. Once this 
routine has finished processing, it exits 
using the code built by the TEXIT macro. 


The proceed form of the IPUT macro must _ be 
used if an IROLL macro was’ issued to the 
application task. The system cannot guarantee 
that the application task is in memory or that 
it can be rolled into memory within a 
reasonable time. 


The ICONT macro relinquishes control of an intercepted SVC _ by 
returning control to an OS/32 SVC executor. 


Format: 
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' 
’ 
OPERATION ; OPERAND 


RDB=pointer 


[ -ERROR=pointer| 


} 
1 
| 
| [-PCB=pointer | 
| [FORM=L | 


em we 


Parameters: 


RDB= is the address of the RDB buffer built for the 
intercepted SVC. 

ERROR= is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for code built by this macro, execution 


branches to this error routine. 


If this parameter is omitted and ae run-time 
error occurs, execution resumes with the 
instruction following the code built by the 
macro. 


PCB= is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. 


If this parameter is omitted, a new PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 


FORM= L requests a PCB be built but not accessed. 
A PCB is built for this macro and initialized 
with values. Subsequent macros can refer to 
this PCB via the PCB parameter. 


4.13.6  IPROCEED Macro 


After an SVC has been intercepted, the intercepting task can 
execute code built by an IPROCEED macro to allow the application 
task that issued the SVC to proceed with its execution. Until 
the intercepting task executes code built by an IPROCEED macro, 
the application task is in a wait state. 


Format: 
' 
NAME {| OPERATION  } OPERAND 
symbo 1 I PROCEED RDB=pointer 


[ ERROR=po inter | 


i 

1 

H 

i] 

| [-PCB=pointer | 
| [: FORM=L | 

1 

i 


[: cC=n | 
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Parameters: 


PCB= 


FORM= 


4.13.7 IROLL Macro 


is the address of the RDB buffer built for the 
intercepted SVC. 


is the address of an error routine within the 


intercepting task. If a run-time error occurs 
for code built by this macro, execution 
branches to this error. routine. If this 


parameter is omitted and a_erun-time error 
occurs, execution resumes with the instruction 
following code built by the macro. 


is the address of a PCB previously constructed 


and initialized by the FORM=L parameter. If 
this parameter is omitted, a new PCB is 
automatically built and initialized with 


values corresponding to the other specified 
parameters. 


L requests a PCB be built but not assessed. 
A PCB is built for this macro and initialized 
with values. Subsequent macros can refer to 
this PCB via the PCB parameter. 


nis a decimal number specifying the setting 
of the application task PSW condition code 
after the SVC instruction execution. If the 
CC parameter is omitted, the condition code of 
the application task PSW is set to zero. 


After an SVC is intercepted, an [ROLL macro lets an intercepting 


task change 


the status of the application task from nonrollable 


to rollable, provided that the task was established as rollable 


by Link. This 


allows OS/32 to roll out a éetask having an 


intercepted SVC that requires lengthy processing. 


Format: 
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4 ; 
' 
OPERATION |} OPERAND 


RDB=pointer 


[: ERROR=po inter | 


i 
H 
H 
] 
! [.PCB=pointer | 
| [-FORM=L | 


oe ee 


Parameters: 


RDB= is the address of the RDB buffer built for the 
intercepted SVC. 

ERROR= is the address of an error routine within the 
intercepting task. I1f a run-time error occurs 
for this macro, execution branches to this 
error routine. If this parameter is omitted 


and a run-time error occurs, execution resumes 
with the instruction following the macro. 


PCB= is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. If 
this parameter is omitted, a new PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 

FORM= L requests a PCB be built but not accessed. 


A PCB is built for this macro and initialized 
with values. Subsequent macros can refer to 
this PCB via the PCB parameter. 


4.13.8 ITERM Macro 


The ITERM macro terminates SVC processing. It also allows an 
intercepting task to return the parameter block of the SVC it 
processed to the application task that issued the SVC. The 


returned parameter block can have updated information such as 
status, number of bytes transferred, etc. 


Format: 
NAME {| OPERATION ; OPERAND 
symbol ITERM RDB=pointer 
, TRAP=pointer 
Y 
, COPY= 
N 


[: ERROR=po inter | 
[-PCB=pointer | 


[: FORM=L | 


[: cc=n | 
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Parameters: 


RDB= 


TRAP= 


COPY= 


ERROR= 


PCB= 


FORM= 
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is the address of the RDB buffer built for the 
intercepted SVC. 


is the address of a fullword that contains an 
item to be added to the task queue of the 
application task whose SVC is intercepted. 


Y (yes) indicates that the SVC parameter block 
in the RDB is to be copied back into the 
parameter block of the intercepted SVC. 


N (no) indicates the copy operation is not 
performed. If this parameter is omitted, N is 


the default. 


is the address of an error routine within the 


intercepting task. If a run-time error occurs 
for code built by this macro, execution 
branches to this error. routine. If this 


parameter is omitted and aerun-time error 
occurs, execution resumes with the instruction 
following the code built by the macro. 


is the address of a PCB previously constructed 


and initialized by the FORM=L parameter. If 
this parameter is omitted, a new PCB is 
automatically built and initialized with 


values corresponding to the other specified 
parameters. 


L requests a PCB be built but not accessed. 
A PCB is built for this macro and initialized 
with values. Subsequent macros can refer to 
this PCB via the PCB parameter. 


n is a decimal number specifying the setting 
of the application task PSW condition code 
after the SVC instruction execution. If the 
CC parameter is omitted, the condition code of 
the application task PSW is set to zero. 


4.13.9 ITRAP Macro 


The ITRAP macro allows an intercepting task to send a task queue 
item to an application task whose SVC is intercepted. The task 
queue item can be any of the task queue items supported by 0S/32. 


Format: 


| 
! 
OPERATION — ; OPERAND 


Parameters: 


RDB= 


TID= 


RDB=pointer 
\ribeccaneart 

, TRAP=pointer 
[ ERROR=po inter | 
[: PCB=po inter | 
[: FORM=L | 


[" DONE=adar | 


is the address of the RDB buffer built for the 
intercepted SVC. 


is the address of a fullword containing the 
taskid for the task. Before issuing an ITRAP 
macro with the TID parameter, the intercepting 
task must have obtained the task identifier 
from an RDB and placed it into the fullword 
location. 


NOTE 
The TID form of this macro can be 


used to send a trap to a task that 
is not being intercepted. 
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TRAP= 


ERROR= 


PCB= 


FORM= 


DONE= 
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is the address of a fullword that contains an 
item to be added to the task queue of the 
application task having an SVC that is 
intercepted. 


is the address of an error routine within the 


intercepting task. If a run-time error occurs 
for code built by this macro, execution 
branches to this error. routine. If this 


parameter is omitted and a run-time error 
occurs, execution resumes with the instruction 
following the code built by the macro. 


is the address of a PCB previously constructed 


and initialized by the FORM=L parameter. If 
this parameter is omitted, a new PCB is 
automatically built and initialized with 


values corresponding to the other specified 
parameters. 


L requests a PCB be built but not accessed. 
A PCB is built for this macro and initialized 
with values. Subsequent macros can refer to 
this PCB via the PCB parameter. 


is an address that specifies that the macro is 
to be a PROCEED call. When the call is 
completed, a task event interrupt occurs, 
using the routine whose address is specified 
in the DONE parameter. This routine enters 
with general register O containing the error 
code for the call and general register 1 
pointing to the macro's parameter block. Once 
this routine has finished processing, the 
intercepting task exits using code built by 
the TEXIT macro. 


The proceed form of the ITRAP macro must _ be 
used if an IROLL macro was specified in the 
application task having an SVC that is 
intercepted. The system cannot guarantee that 
the application task is in memory or that it 
can be rolled into memory within a reasonable 
time. 


4.13.10 IERRTST Macro 


The IERRTST macro allows an intercepting task to evaluate errors 


resulting 


from 


execution of code built by intercept macros in 


order to branch to appropriate error handling routines. 


Format: 


{ 
' 
OPERATION  }; OPERAND 


een en ee ee 


Parameters: 


xxX= 


Pointer 


IERRTST 


xx=pointer 


[ xx=po inter] 


[ PCB=pointer | 


i | ELSE=pointer 
iad aa 
i 

| 

{| [FORM=L 

Pee | 


is a two-character alphabetic string 
specifying one of the error codes for the 
intercept macros. See Table 4-2. 


specifies the name of an intercepting task 
error routine that handles’ errors having a 
returned error code identical to the one 
specified by the xx parameter. For instance, 
an IERRTST macro might include these 
parameters for evaluating an IPUT macro: 


IERRTST AD=pointer ,NT=pointer ,RD=pointer 


These parameters specify the addresses of the 
error routines to which execution will branch 
whenever the returned error code equals’ AD, 
NT, or RD. 
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ELSE= is the name of an error routine to be executed 
for errors other than those specified in the 
XX parameter. If this parameter is omitted, 
either of the following actions occurs’ for 
returned errors: 


e If the returned error code corresponds’ to 
the one specified by the xx parameter, 
execution branches to ae specific error 
routine. 


e If the returned error code does not 
correspond to the one specified by the xx 
parameter, execution branches to the 
instruction immediately following the code 
built by the IERRTST macro. 


PCB= is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. If 
this parameter is omitted, a new PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 

FORM= L requests a PCB be built but not accessed. 


A PCB is built for this macro and initialized 
with values. Subsequent macros can refer to 
this PCB via the PCB parameter. 


4.13.11 $RDB Macro 


The $RDB macro is used to define a structure containing the 
symbolic names for all of the RDB fields. It is recommended that 
symbolic names be used to refer to the RDB fields instead of 
coding the hexadecimal offsets to the fields. 


Format: 
H i 
NAME ' OPERATION i OPERAND 
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4.14 SAMPLE SUPERVISOR CALL (SVC) INTERCEPTION PROGRAMS 
The following program uses SVC interception software to intercept 


SVC 1 to the existing real device MAG]. Each time an SVC 1 is 
issued to MAGI, the program prints out the following message: 


SVC 1 CALL INTERCEPTED 


The SVC 1 is terminated with a device unavailable error code 
(X'AO'). 


$RDB DEFINES AN RDB STRUCTURE 


* ADD AN RDB BUFFER ADDRESS TO THE RDB BUFFER ADDRESS LIST. 


LA O, RDB LOAD THE ADDRESS OF THE RDB 
* INTO REGISTER O 

ABL O,BUFLIST ADD THE ADDRESS OF THE RDB 
- TO THE CIRCULAR LIST 


* CREATE THE INTERCEPT PATH 


ICREATE NAME=INTNAME, FD FOR DEVICE NAME X 
MODE=RX, RECIPIENT-EXISTENT MODE X 
CONTROL=FC, GIVES INTERCEPTING TASK FULL CONTROL X 
SVC=(1), ALL SVC 1 ARE TO BE INTERCEPTED x 
EXEC=INTRTN, POINTS TO THE SVC EXECUTOR ROUTINE X 


BUFFERL=BUFLIST, ASSIGNS POINTER TO FREE BUFFER LIST x 
PID=PATHID, DATA AREA FOR INTERCEPT PATH ID x 
ERROR=BOMBOUT ERROR ROUTINE FOR ICREATE MACRO 
IF ERROR OCCURS IN ICREATE MACRO ENABLE TASK EVENT TRAP SO TASK 
CAN GO INTO TRAP WAIT FOR INTERCEPTS TO OCCUR 
* LOAD TSW WITH WAIT STATE SET AND TASK EVENT TRAPS ENABLED 
LTSW TETS,WT 


* COME HERE IF ERROR OCCURS IN ICREATE MACRO 
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BOMBOUT SVC 3,1 FAIL TASK ON ERROR 


* ALLOCATE DATA AREA FOR ICREATE 


ALIGN 4 
INTNAME DC C* : NODE NAME 

DC Cc} : RESERVED 

DC C'MAG1' DEVICE NAME 

DC Ce ' FILE NAME PART 1 

DC c* : FIT.E NAME PART 2 

DC Cc : EXTENSION 
BUFLIST DLIST 1 DESIGNATE 1 RDB IN CIRCULAR LIST 
RDB DS RDB.PB+20 ALLOCATES SIZE OF RDB + SVC 1 
PATHID DS 2 DESIGNATE AREA FOR PATH ID 


* TRAP EVENT SERVICE ROUTINE 
* THE FOLLOWING ROUTINE IS EXECUTED WHEN AN SVC IS INTERCEPTED 


INTRTN SVC 2,NOTIFY LOG MESSAGE THAT SVC 1 WAS INTER- 
x CEPTED 

LHI 0,X'AOQOO' RETURN DEVICE UNAVAILABLE STATUS 
x FOR INTERCEPTED SVC 1 

STH 0,RDB.PB+2(1) SAVE SVC 1 STATUS IN STATUS FIETD 
x OF RDB 
x 
* TERMINATE THE INTERCEPTED CALL, COPYING THE MODIFIED SVC 
* PARAMETER BLOCK IN THE RDB BACK OVER THE USER'S SVC PARAMETER 
x 


BLOCK. 


ITERM RDB=(1),COPY=Y 


TEXIT EXIT THE TASK EVENT ROUTINE 
* ALLOCATE DATA AREA FOR TRAP EVENT SERVICE ROUTINE 
ALIGN 4 
NOTIFY DB 0O,7,0,22 
DC C'svC 1 CALL INTERCEPTED' 
END 
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The following program creates a pseudo device to which a_ u-task 
can assign and write. The user's data buffer is passed to the 
OS/32 command processor via SVC 2 code 14 to be executed as a 
command line. 


IRDR PROG SVC INTERCEPT EXAMPLE - INTERNAL READER 


WRK KKK KK EEK KKK KKK KEK KEK KKK KKK KKK EEK KKK KK KKK KKK KEK KKK KKK 
ROR KIO KKK KKK KEK KK KK KOK KKK ERK KKK KKK KKK KKK KKK KKK KE KKK KEK 


x x 
x x 
* This task creates a pseudo device to which a user task * 
* can assign and write. The user's data buffer is * 
* passed to the OS command processor via a SVC 2,14 to ig 
7 be executed as a command line. * 
x x 


x x 
KKK KKK KK KEK KKK KEK KKK KKK KKK KE KKK KKK KKK KKK KKK KEKE KKK KKK KEKE EK 
ROKK OK KKK KKK KKK KEKE KKK KK KEK KKK KK KEK KKK KKK KKK KKK KKK KKK 


ROO EQU 0 
ROL EQU) Ll 
RO2 EQU 2 
RO3 EQU 3 
RO4 EQU 4 
ROS EQU 5 
ROG EQU 6 
RO7 EQU 7 
ROS EQU 8 
ROO EQU 9 
R10 EQU 110 
Rll EQU) 11 
R12 EQU 12 
R13 EQU 13 
R14 EQU 14 
R15 EQU 15 
SPACE 3 
NLSTM 
NLSTU 
$SVCl 
$SVC7 
$RDB 
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TITLE 


INTERCEPT PATH CREATION 


WRK KKK KK KEK KK KKK Kw koko RO KOR KOKO KOKO KKK KKK 


* 
* 
x 


IRDR 


INTRDB 


x 


SET UP INTERCEPT PATHS x 
x 

KKK KOK KO KKK KKK KOKO Ok kkk ok kok Kk ROOK KOKO KK KKK RAK KEK KKK KK 

EQU * 

SVC 2,PEEKO1 GET NAME OF SYSTEM CONSOLE 

E ROO, CON 

ST ROO, SVC7. VOL+SVC7CON 

LHI ROO,SV7.ASGN!SV7.SRW 

SLL ROO,16 ASSIGN LU 0 SRW 

ST ROO, SVC7.OPT+SVC7CON 

SVC  7,SVC7CON ASSIGN TO SYSTEM CONSOI.E 

LB ROO, SVC7.STA+SVC7CON 

LR ROO, ROO WAS THE ASSIGN OK? 

BNZ BADCON NO 

LIS ROO,0 CHANGE SVC 7 TO FETCH ATTR 

STH ROO,SVC7.OPT+SVC7CON 

SVC 7,SVC7CON FETCH ATTRIBUTES ON CON: 

LB ROO, SVC7 ..STA+SVC7CON 

LR ROO, ROO WAS THE FETCH OK? 

BNZ  BADCON NO 

LHI ROO,SV7.CLOS CHANGE SVC 7 TO CLOSE 

SRLS RO0O,8 DO NOT DESTROY DEVICE CODE 

STB ROO,SVC7.OPT+SVC7CON 

SVC 7,SVC7CON CLOSE THE SYSTEM CONSOI.E 

LB ROO, SVC7.STA+SVC7CON 

LR ROO, ROO WAS THE CLOSE OK? 

BNZ BADCON NO 

LHI ROO,X'7FFF' BAD LENGTH FOR SVC 2,14 TO GET 

STH ROO,COMMAND+4 MAX LENGTH ALLOWED BY SYSTEM 

SVC  2,COMMAND WILL GET ERROR STATUS 3 

LH ROO, COMMAND+6 USE AS IRDR LENGTH 

STH  ROO,SVC7.LRC+SVC7CON 

SPACE 1 

LHI ROO,RDBNUM NUMBER OF RDB'S 

LA RO1, RDBPOOL ADDRESS OF RDB POOL 

EQU * 

ATL RO1,RDBP ADD RDB TO QUEUE 

AHI RO1,RDBSIZE ADDRESS OF NEXT RDB 

SIS ROO,1 ALL RDB'S ADDED TO QUEUE? 

BNZ  INTRDB NO 

SPACE 1 

ICREATE SVC=(7) ,MODE=RN,NAME=NAME, X 


CONTROL=FC,BUFFERL=RDBP, PID=PID,EXEC=INT7 


IERRTST FD=BADFD,EX=BADEX, ELSE=BADALL 
ICREATE SVC=(1),MODE=RX,NAME=NAME, PBSIZE=SVC1X, X 


CONTROL=FC, BUFFERL=RDBP, PID=PID, EXEC=INT1 


IERRTST FD=BADFD, EX=BADEX, ELSE=BADALL 


SPACE 
LTSW 


1 
WT, TETS ENTER TRAP WAIT 


SPACE 3 
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BADFD 


BADEX 


BADALL 


BADCON 


LOGFD 
LOGEX 
STRANGE 
LOGCON 
NAME 
PID 
RDBNUM 
RDBSIZE 


RDBP 
RDBPOOL 


2,LOGFD 


2, LOGEX 

3,1 

2, STRANGE 

3,1 

2, LOGCON 

3,1 

1 

4 

H'7',H'8' 
C'FD ERROR‘ 
H'7',H'8' 
C'EX ERROR‘ 
H'7',H'8! 
C'!! ERROR‘ 
H'7',H‘'12'° 
C'!!CON ERROR 
1 

Ce IRDR 
lL 

1 

3 

RDB.+SVC7. 
RDBNUM 
RDBS I ZE* RDBNUM 


NUMBER OF RDB'S IN POOL 
MAXIMUM SIZE OF RDB 


RDB POOL 
RDB BUFFERS 
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TITLE SVC 7 TEQ HANDI.ER 


SOK OOK OO kkk koko kok koko koko kok Kk OO KK KKK KKK KK KKK KKK KK KK 


* x 
x SVC 7 INTERCEPT EXECUTOR x 
x x 
cK ko kkk kok KOKO koko kok ok kok ok ok kkk kkk kkk kok kkk kkk kK K KEK KKK KKK KKK KK 
INT7 EQU * 

LR R10,RO1 SAVE RDB POINTER 

LR R11,R10 

AH R11,RDB.OFF (R10) ADDRESS OF SVC 7 PBLK 

LB ROO,SVC7.OPT(R11) GET SVC 7 OPTIONS 

LR ROO, ROO FETCH ATTRIBUTES? 

BZ DOFETCH YES 

CLHI ROO,X'FF' EXTENDED SVC 7 FUNCTIONS? 

BE INT7.NS YES - NOT SUPPORTED 

THI ROO,X'40' ASSIGN? 

BNZ DOOPEN YES 

THI ROO,X‘'04' CLOSE? 

BNZ DOCLOSE YES 

THI ROO,X‘'21' CHAP OR CHECKPOINT? 

BNZ INT7.1G YES - IGNORE 

SPACE 1 
INT7.NS EQU * 

SVC 2,UNPACK7 PUT SVC 7 OPTION IN ERROR MESSAGE 

SVC 2,LOG7ERRC AND LOG ERROR MESSAGE 

LIS R00,1 RETURN ILLEGAL FUNCTION TO USER 


STB ROO, SVC7.STA(R11) AS AN ERROR STATUS 
ITERM PCB=TERM,RDB=(R10) TERMINATE THIS SVC 7 


TEXIT PCB=EXIT EXIT FROM TEQ HANDLER 
SPACE 3 

x 

* IGNORE SVC 7 COMMAND PROCESSOR 


x 


INT7.IG EQU x 
ITERM PCB=TERM,RDB=(R10) IGNORE THIS SVC 7 
TEXIT PCB=EXIT EXIT FROM TEQ HANDLER 
SPACE 3 


48-040 FOO RO2 4-41 


x 
x 
x 


DOOPEN 


OPEN .OK 


OPEN.ERR 


OPEN PROCESSOR 


EQU 


STB 


x 


R15,SVC7.OPT+1(R11) GET ACCESS PRIVILEGES 


R15,5 
R15,2 
OPEN.ERR 
OPEN . OK 
2 


SRO = 0 & ERO = 1 
REQUESTING READ ONLY ACCESS? 
YES - ERROR 

SKIP SECURITY CHECK 


USER DEFINED SECURITY CHECK FOLLOWS -------------------- 


R15,RDB.TID(R10) 
R15,TID 

2, PEEKO3 
R14,MONITOR 
R14,C'.MT™M' 
OPEN. OK 
R15,C' ' 
OPEN .OK 
R14, TASKNAME 
R14,C'LEE ' 
OPEN.ERR 
R15,C! ' 
OPEN .ERR 
R15, LEGACY 
R15,C'CT42' 
OPEN.ERR 
R15,ACCT.P 
R15,29 
OPEN.ERR 
R15,ACCT.G 
R15,18 
OPEN.ERR 


PCB=CONT, RDB=(R10) 
PCB=EXIT 

2 

x 

R15,9 
R15,SVC7.STA(R11) 


ITERM PCB=TERM, RDB=(R10) 


TEXIT 
SPACE 


PCB#EXIT 
3 


MOVE TID FOR PEEKO3 


INFO ON USER TASK 
GET NAME OF USERS MONITOR 
TASK A SUB-TASK OF MTM? 


NO 

BE SURE 

NO? 

GET NAME OF USER 
IS IT ME? 

NO 

BE SURE 

NO? 


GET NAME OF USERS TERMINAL 

IS IT MINE? 

NO 

GET USERS PRIVATE ACCOUNT NUMBER 
AM I IN MY ACCOUNT? 

NO 

GET USERS GROUP ACCOUNT NUMBER 

DO I HAVE MY CORRECT GROUP ACCOUNT? 
NO 


RETURN TO OS SVC 7 EXECUTOR 
EXIT FROM TEQ HANDILER 


RETURN ASSIGNMENT ERROR TO USER 


RETURN BAD STATUS TO USER 
EXIT FROM TEQ HANDLER 
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x 


x CLOSE PROCESSOR 

x 

DOCLOSE EQU- * 
ICONT PCB=CONT,RDB=(R10) RETURN OS OS SVC 7 EXECUTOR 
TEXIT PCB=EXIT EXIT FROM TEQ HANDLER 
SPACE 3 


* 


* FETCH ATTRIBUTES PROCESSOR 

x 

DOFETCH EQU- * 
LA RO9, SVC7CON GET ADDRESS OF FETCH ATTR OF CON 
LB R15,SVC7.OPT+1(RO9) MOVE DEVICE CODE 
STB R15,SVC7.OPT+1(R11) 


LIS R15,0 GOOD STATUS 
. STB R15,SVC7.STA(R11) 
L R15,SVC7.KEY(RO9) DEVICE ATTR & RECORD LENGTH 
ST R15,SVC7.KEY (R11) 
L R15,NAME+8 IRDR DEVICE NAME 


st R15,SVC7.VOL(R11) 

LM R12,SVC7.FNM(ROQ) 

STM R12,SVC7.FNM(R11) 

ITERM PCB=TERM,RDB=(R10) RETURN SVC 7 FETCH PBLK TO USER 
TEXIT PCB=EXIT EXIT FROM TEQ HANDLER 
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TITI.E SVC 1 TEQ HANDI.ER 


KKK KKK KR KKK KEK KKK KKK KR SOOKOIOK KOKOOOOIOOKIOK K KK KKK KKK KK 


* x 
* SVC 1 INTERCEPT EXECUTOR > 
* x 
SOOO IDI IG IIGIOIOIIOIOIOIOIGIOIOIOIOIOIOIOIOIOIOIOI OOOO OOOO OIC OOOO GOI III II IOI IO 
INTL EQU is 


LR R10,R01 
LR RO7,R10 
AH RO7,RDB.OFF (R10) 
LIS R14,0 
LIS R15,0 
LB R13,SVC1.FC(RO7) 
THI R13,SV1.CMDF 
BNZ ECHODONE 
THI R13,SV1.WRIT 


SAVE RDB ADDRESS 


ADDRESS OF SVC 1 PBLK 

NO ERROR ON COMMAND FUNCTION 
LENGTH OF TRANSFER 

GET FUNCTION CODE 

COMMAND FUNCTION? 

YES - TREAT AS A NOP 

IS USER DOING A WRITE? 


BNZ INT1.WRT YES 
* 
x A read from the internal reader will give the 
a! user an illegal function status. 
x 
LHI R14,X'COO00' ILLEGAL FUNCTION ON READ 
B ECHODONE FINISH UP 
x 
x Queue the user's command line to the internal reader 


INTL.WRT EQU- * 


L R11,SVC1.SAD(RO7) 
L R12,SVC1.EAD(RO7) 
IGET 


GET START ADDRESS 
AND END ADDRESS 


RDB=(R10) ,SDST=BUFFER, SDEND=BUFEND, 


ADST=(R11) ,ADEND=(R12) 


SR R12,R11 

LR R15,R12 

AIS R15,1 

STH R15, COMMAND+4 
Svc 2, COMMAND 

LH R14, COMMAND + 2 


BZ ECHODONE 
LHI R14,X'AOOO' 
SPACE 1 


ECHODONE EQU x 
STH R14,SVC1.STA(RO7) 
ST R15,SVC1.LXF (RO7) 
THI R13,SV1.WAIT 
BNZ ECHOWAIT 
SPACE 1 
L R15,RDB.PAD(R10) 
OI R15,Y'O8000000' 
ST R15, TRAP 
SPACE 1 


GET LENGTH-1 OF STRING 
LENGTH OF USER COMMAND LINE 


PASS COMMAND TO IREADER 
COMMAND QUEUED TO IREADER? 
YES 

NO - GIVE DEVICE UNAVAILABLE 


RETURN STATUS 

RETURN LENGTH 

IS USER REQUEST A WAIT? 
YES - NO NEED FOR A TRAP 


GET ADDRESS OF USER SVC 1 PBLK 
I/O PROCEED COMPLETION PARAMETER 


ITERM RDB=(R10),TRAP=TRAP,COPY#Y TERMINATE WITH TRAP 


TEXIT PCB=EXIT 
SPACE 1 
ECHOWAIT EQU : 


ITERM PCB=TERM, RDB=(R10) 


TEXIT PCB=EXIT 


EXIT FROM TEQ HANDLER 


TERMINATE THIS SVC 1 
EXIT FROM TEQ HANDLER 
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UNPACK7 


LOG7ERRC 


SVC7ERRC 
LOG 7ERRX 


TRAP 


CONT 


TERM 


EXIT 


PEEKO1 


CON 


SVC7CON 


PEEKO3 
TID 
TASKNAME 
CTSW 
TOPT 
WAITS 
ACCT .P 
ACCT.G 
L.VOL 
L.FD 
L.EXT 
MONITOR 
LEGACY 
PRIO 


COMMAND 


BUFFER 
BUFEND 
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4 

2,6,0,0 
SVC7ERRC 

0,7 

Z (LOG7ERRX-* ) 


C'UNSUPPORTED SVC 
- INTERCEPTED 


Crs 
a a 


ct 


ORM=L, COPY=Y 


ORM=L 


~ 
ite) 


MPM PMH PHO W PHA HM APH MS HHH * 
fs 


< 
Q 
SI 


,19,0,0 


~ 
> 
© 
oO 


’ ’ 


(BUFFER) 


m eee OS en Oe ES ee ee a ee ee 
00 


g 


PUT SVC 7 ERROR CODE IN 


FUNCTION '! 


I/O PROCEED COMPILETION TRAP 


CONTINUE SVC 


TERMINATE SVC 


EXIT SVC 


SYSTEM CONSOLE NAME 


GET INFO AN USER TASK 
USER TASK ID 

NAME OF USER TASK 
CURRENT TASK STATUS WORD 
TASK OPTIONS 

TASK WAITS 


USER'S PRIVATE ACCOUNT NUMBER 


USER'S GROUP ACCOUNT NUMBER 
LOAD VOLUME NAME 

LOAD FILE NAME 

LOAD EXTENSION & FII.E CLASS 
NAME OF MONITOR TASK 

NAME MTM USERS TERMINAL 
TASK PRIORITY 

(RESERVED) 


QUEUE COMMAND TO IREADER 
STATUS 


ADDRESS OF BUFFER 


CHAPTER 5 
OS/32 SUPPORTED INPUT/OUTPUT (1/0) DEVICES 


5.1 INTRODUCTION 


This chapter discusses the functional aspects of the devices 
supported by 0S/32. Specific device dependent information is 
included. 


OS/32 devices and files support ASCII formatting, sequential 
access, unconditional and conditional proceed I/0, and vertical 
forms control (VFC). Device codes associated with Perkin-Elmer 
supported devices range from O through 255. These codes are 
defined in the System Generation/32 (SYSGEN/32) Reference Manual. 


5.2 VERTICAL FORMS CONTROL (VFC) 

VFC provides a means to control the vertical forms motion on an 
output device, such as a line printer or CRT, while writing data. 
Available VFC functions are: 

e Set vertical tabs (EVFU) 

e Vertical space 0-79 before or after printing 

e Vertical tab before or after printing 

@e No space before or after printing (overprint) 

e Select VFU channels 2-12 before and after printing 

@e Horizontal tabs (available with BIOC and local line printer 


drivers only) 


The VFC character is the first character of the user's) output 
buffer and is interpreted to mean one of the above functions. 
VFC characters supported by OS/32 drivers are listed in Appendix 
B. Other bytes in the buffer are considered to be data and are 
output without further interpretation. 


The 0OS/32 routines that control VFC can be shared by all drivers 
requiring VFC character recognition. OS/32 makes no assumption 
as to the type of device calling the routines; device specificity 
is maintained by each individual driver. 
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5.2.1 Horizontal Tabs 


When the BIOC driver encounters a horizontal tab character, the 
driver replaces the character with one or more spaces, as 
determined by the tab stops that were established by the last 
down line load. If a horizontal tab character is encountered at 
a column position beyond the last tab stop, it will be replaced 
by one space. If a horizontal tab character is encountered while 
positioned on a tab stop, the necessary number of spaces will be 
output to position to the next tab stop. 


The local line printer driver expands the tab character (control 
I) to the appropriate number of spaces. Tab stops are defined to 
be every eighth column; i.e., columns 9, 17, 25, etc. This 
feature is enabled via extended device code Xl for device codes 
112, 113, or 114 only. All other drivers output the horizontal 
tab character unmodified. 


5.2.2 Theory of Operation 


For devices that support ASCII output operations (e.g., line 
printer), a write operation begins with a call to the write 
initialization routine to determine if there is any VFC operation 
to be performed before printing. 


If a VFC character is present, the driver performs the VFC 
operation designated by that character. The driver then outputs 
the user's data buffer. On completion, the driver checks for any 
VFC operations that are to be performed after the data is output. 
If a VFC operation is required, the driver performs it. If no 
"after" VFC operation is required, but the current output is VFC, 
the driver enters into a Line feed pending state for the next 
write operation. 


For drivers that support both input and output operations (e.g., 


CRT driver), output operations are performed in the same manner 
aS above. However, the procedure for input operations differs 
slightly. Before an input operation, the cursor’ remains 
positioned where the last output operation left it. To prevent 


the characters that are input from overwriting the previous Line, 
the drive delays echoing the first character input until a line 
feed is output. Two types of echoing can be performed: 


e Software-echo (e.g., BIOC drivers) 


@e Hardware-echo (e.g., ITAM PPSM drivers) 


If a driver uses the software-echo feature, (i.e., the driver 
echoes the characters that are typed in via software control), 
the driver waits for the first character to be typed in by the 
operator. After the character is typed in, the driver performs 
a VFC operation if it is in line feed pending state before the 
character is echoed. 
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If a driver uses the hardware-echo feature and is in line feed 
pending state, the driver first turns off the echo, waits for the 
input character to be typed, performs the VFC operat.ion, outputs 
the character just typed in, and finally turns the hardware-echo 
back on for the remainder of the buffer. 


5.3 CARD READERS 


Perkin-Elmer card readers can accommodate a fixed record length 
of 80 bytes (ASCII), 120 bytes (binary), or 160 bytes (image). 


During read ASCII operations, each card column (12 _ bits) is 
converted into one 8-bit ASCII character. Illegal codes are 
converted into the null character (X'O00') indicating an error has 
occurred. 


During read binary operations, each pair of card columns (12 bits 
each) is unpacked into three bytes having the following format: 


Read Binary Format: 


First card colum 


_,,, yy 


ws ng a i Tl id «x cin Gas vs Gada ea cs et “is mp a a eae + gas 3 hana wml Site ae cay sens Sc Tce acs Fe ie? 
tf 12}; 11; O |; 1} 243 ;,4;5 | 6 | 7} Bigs 
sects nse ice eh tice sel ere ees Bee nea ies ve nat Mik Soe as gh a Sa ee, 
Bytes 
0 1 
Second card column 
) eee Saar sg TA 
12; 11; Of; 1} 2 ;3;' 43;5 gf OY 7} Bi Dy 
P i Se ea ae aks ea tne ee Sl Ge ck a JE a oe 
Bytes 


During read image operations, each column is converted into one 
halfword in the following format (U=undef ined): 


Read Image Format: 


ee lier li or ee Ti Tel eR eee ee i ee eet Meee ce oe ate te Dac cnn cena heated 


Ce i i i ee Reel 


48-040 FOO RO2 53 


The translation for an ASCII read is accomplished through a 


translation table. Devices without hardware translation 
translate 029- or O26-compatible Hollerith code to 8-bit ASCII 
code. Source sysgen options include translation of 029- or 


026-compatible Hollerith code to EBCDIC’ code. The hardware 
translation matches that of the 029-compatible Hollerith to 
EBCDIC translation. 


5.4 CARD READER/PUNCH DEVICES 


Card reader/punch devices supported by Perkin-Elmer 32-bit 
computers accommodate fixed record lengths of 80 bytes (ASCII), 
120 bytes (column binary), and 160 bytes (image). 


During read ASCII operations, each card column (12 bits) is 
converted into one 8-bit ASCII character. Illegal codes are 
converted into the null character (X'00') indicating an error has 
occurred. 

During read binary operations, each pair of card columns (12 bits 
each) is unpacked into three bytes having the following format: 


Read Binary Format: 


First card column 


(en 


Q-- ~ +--+ +--+ + + ee 
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cr 
i 
fra) 


During read image operations, each card column (12 bits each) is 
placed into a halfword in the following format: 


Read Image Format: 


ee ee ee ee ee ee ted ied 


ee i ee ene i eee en han dianatictad en eect and on edt eed eda el 


During write ASCII operations, each byte of data is translated 

from ASCII into a 12-bit Hollerith code. Depending on the device 

code chosen, the following can occur: 

e All data is punched and printed. 

e Data is punched only. 

e Of each 160 bytes of data accepted, the first 80 bytes are 
punched while the second 80 bytes are printed. 


During write binary operations, each 3-byte group is packed into 
two columns on the card in the following format. Nothing is 
printed on top of the card. 


Write Binary Format: 


de iperasites On ceetolea cos eee eats Se ee een 
(Or? 243) 4 5} OF TFT} OT LY 2G 3 

ee eee len Bete eae te ee sg aed ad aut Sa Cae os ele nea 2 
Bytes 

0 1 


Even Column 


fia sue TN 
Peete oe ee ee eee eee ee eth neo es 
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During write image operations, the low order 12 bits of each 
halfword are punched according to the following format. Nothing 
is printed on top of the card. Bits O through 3 are ignored. 


Write Image Format: 


The translation for ASCII operations is accomplished through a 
translation table. The standard translation is 8-bit ASCII code 
to 029-compatible Hollerith code. 


Source sysgen options include 8-bit ASCII code to 026-compatible 
Hollerith code and also EBCDIC code to 026- or 029-compatible 
Hollerith codes. 


5.5 TELETYPE (TTY) READER/PUNCH 


Perkin-Elmer TTY reader/punch devices support read and write 
ASCII, read and write binary, and read and write image 
operations. Variable length records are also accommodated. 


During read ASCII operations, an X-ON character is output to turn 
the reader on. The tape is read in blocked mode so data is not 
copied to the printer while it is being read. Leading blank 


frames and delete characters are ignored. Data is masked to 
7-bit ASCII. The transfer is terminated on buffer full or when 
a carriage return character is read, whichever occurs first. On 


termination of the transfer, the tape is advanced to the next 
delete character or blank frame. An X-OFF character is output to 
stop the tape. 


During read binary operations, an X-ON character is output to 
turn on the tape. The tape is skipped until the first nonblank 
frame is found. If the first nmonblank character is X'FO', 
subsequent frames are read in until the user buffer is full. The 
characters are read in unzoned binary format. 


If the first nonblank character read is not X'FO', the characters 
are read in zoned binary format, stripped of their zones, and 


packed into the user buffer. Transfer begins with the first 
nonblank frame after X'FO'. Only punches X‘'90‘', xX‘'81* through 
X'84', and X'95‘' through X'9F' are read. Other characters are 


ignored. When the user buffer is full, the tape is advanced to 
the next blank frame. 
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During read image operations, none of the above formatting 
operations are performed. An X-ON character is output to turn 
the tape on, and data is read into the user buffer until the 
buffer is full. The X-OFF character is then output to turn the 
tape off and the transfer is complete. 


During write ASCII operations, the driver outputs a RUBOUT-TAPE 
RUBOUT—-RUBOUT sequence in order to initialize the fTTY 
reperforator. Eight frames of blank tape are output as leader, 
the user data is output until the buffer is empty, or a carriage 
return character is encountered, whichever occurs first. The 
driver ensures that a CR-LF-TAPE OFF-RUBOUT sequence terminates 
the record. 


During write binary operations, the driver outputs a 
RUBOUT-TAPE-RUBOUT-RUBOUT sequence, followed by eight blank 
frames of leader. The user buffer is output, translating each 
byte into two frames of zoned binary data. The transfer is 
terminated when the buffer is empty. The driver outputs a TAPE 
OFF-RUBOUT sequence. 


During write image operations, none of the above formatting or 
control operations are performed. The user buffer is output 
until the buffer is empty. 


On ASCII or image write, it is possible to inadvertently turn off 
the punch by outputting a TAPE OFF character. On image write, it 
is the responsibility of the user to place the necessary control 
characters, such as TAPE and TAPE OFF, in the user buffer to 
control the operation of the tape. 


Since the reader/punch portion of the TTY is connected to the 
keyboard/printer portion, only one of these devices can be active 
at atime. On ASCII write, the data punched on the tape is also 
printed on the printer. 


5.6 TELETYPE (TTY) KEYBOARD/PRINTER 


Perkin-Elmer TTY Keyboard/printers accommodate variable length 
records and can be interfaced to current loop devices. 


In non-VFC read ASCII operations, data read is masked to /7-bit 
ASCII. Data is read until the buffer is full or a carriage 
return is found, whichever occurs’) first. Upon termination, a 
carriage return/line feed (CR/LF) sequence is sent to the 
printer. 


In non-VFC write ASCII operations, the buffer is scanned to 
eliminate trailing blanks. Data is then output until the buffer 
is exhausted or until a carriage return is found in the data 
stream. A line feed is automatically appended to the detected 
Carriage return; or if no carriage return is detected, a CR/IF 
sequence is output after the last nonblank character. 
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During non-VFC image I/O, none of the above formatting actions 
occur. The amount of data requested is printed or read in, 
without masking to 7-bit ASCII, eliminating trailing blanks, 
checking for control characters, or detecting or appending 
carriage returns or line feeds. On image read, however, a 
carriage return is detected as an end of line sentinel. 


For information on I/O operations with VFC, see Section 5.2. See 
the OS/32 Operator Reference Manual for an explanation of the 
function control keys available on Perkin-Elmer TTY 
keyboard/printers. 


While the reader/punch of an ASR TTY is treated as a separate 
device, LG cannot operate simultaneously with the 
keyboard/printer. 

5.7 PAPER TAPE EQUIPMENT 


Variable record lengths are supported by Perkin-Elmer paper tape 


devices. During read ASCII operations, leading blank tape and 
delete characters are ignored. Data is masked to /7-bit ASCII. 
Carriage return terminates” read. On termination, the tape is 


advanced until either a blank frame or a delete character is 
read. 


During read binary operations, tape is advanced until a nonzero 


character is read. If this character is X'FO', the tape is read 
until the buffer is full (unzoned binary). If the first nonzero 
character is not X'FO', the tape is treated as a zoned binary 


tape. Each two characters are stripped of their zones, merged 
into one byte, and placed in the buffer until the buffer is full. 
On buffer full, the tape is advanced until blank tape is found. 
In zoned binary mode, the only valid characters” are: X'90', 
X'81l' - X'84' and X'95' - X'SF'. All other characters cause the 
transfer to end with a transfer error status. 


During read image operations, the tape is read until the buffer 
is full. 


During write ASCII operations, eight frames of blank tape are 
output. The user buffer is output up to (but not including) 
Carriage return or until the buffer is empty. CR/I.F is then 
output. 


During write binary operations, eight frames of blank tape are 
output followed by the character X'FO'. The user buffer is 
output until the buffer is empty. 


During write image operations, the user buffer is output until 
the buffer is empty. 


9-8 48-040 FOO RC2 


5.8 LINE PRINTERS 


Perkin-Elmer line printers support variable record lengths up to 
132 bytes. 


During non-VFC write ASCII operations, the user buffer is output 
until a carriage return is found or until the buffer is empty. 
At buffer termination, the system ensures that the buffer is 
printed and the paper is spaced upward one line. 


During non-VFC write image operations, the user buffer is output 
exactly as it exists in memory. The system does not ensure that 
the data is printed or that the paper is properly moved. The 
user should be familiar with the characteristics of the 
particular device being used. 


For information on I/O operations with VFC, see Section 5.2. 


5.9 TAPE CASSETTE 


Variable length records are supported by Perkin-Elmer tape 
cassettes. During input, ASCII, binary, and image modes are 
identical. Data is read from the cassette into the user buffer. 
The transfer terminates when the buffer is full or at end of 
record, whichever comes first. If the record is longer than the 
buffer, error status is not’ returned. Parity errors in the 
unread part of the record can be detected. If a parity error 
occurs, five retries are attempted before error status is 
returned. When a parity error status is returned, the tape is 
positioned in the interrecord gap following the record in error. 


During output, ASCII, binary, and image modes are identical. 
Data is written from the user buffer until the buffer is empty. 
The system retries five times on parity errors. 


The driver generates an end of tape condition, whether the tape 
is positioned at the beginning or at the end of the reel. It 
must be assumed from the last operation what position end of tape 
is actually referring to. 


Since the two drives on an intertape cassette share logic, only 
one drive of a cassette pair (e.g., X'45' and X‘'55') can be 
active at a time. 

Continuous mode operations are used to pass requests to the 
driver within the time required (10 milliseconds for read; 30 
milliseconds for backspace). 


5.10 MAGNETIC TAPE 


Data transfer operations can be performed in standard and gapless 
I/O format. 
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§.10.1 Standard Input/Output (1/0) 


Variable length records are supported by Perkin-Elmer magnetic 
tape devices. During input, data is read into the user buffer 
from the magnetic tape. The transfer ends on buffer full or’ end 
of record, whichever comes first. If a parity error occurs, the 
driver retries the read operation before an error status is 
returned. The number of retries performed is determined by the 
retry value set in the DCB or specified by the user in the SVC l1 
extended function code field for data transfer operations. After 
a parity error occurs during a read forward operation, the tape 
igs positioned in the interrecord gap preceding the record with 
the error. If an error occurs during a read backward operation, 
the tape is physically positioned following the record with the 
error. 


During output, data is written from the user buffer to the 
magnetic tape until the buffer is empty. On parity error, the 
tape is positioned before the record causing the error, the 
record gap is extended and the write operation is retried. 
Again, the number of retries is determined by the retry value set 
in the DCB or specified in the SVC 1 parameter block. 


In addition to giving users control over the number of retries 
for data transfer errors, OS/32 provides the ability to erase a 
variable length of tape and to select the recording density, via 
SvC 1 and SVC 7, respectively. See the OS/32 Supervisor Call 
(SVC) Reference Manual for more information on how to implement 
these features. 


For read and write requests, ASCII, binary, and image requests 
are identical. 


The minimum number of bytes that can be transferred by a tape 
drive is four. All data transfers must start on a halfword 
(i.e., even byte) boundary and should specify an even number of 
bytes (i.e., end address odd). 


On a read operation, end of tape may be detected on a different 
record than on ae write operation because of mechanical tape 
positioning. If rewind is issued at beginning of tape, the 
driver returns normal status. Ensure that the tape is loaded at 
beginning of tape unless some other condition is expected. 


5-10 48-040 FOO RO2 


5.10.2 Gapless Input/Output (1/0) 


Data transfer operations in gapless mode consist of a task 
reading or writing data buffers to a magnetic tape with no 
intervening interrecord gaps, using only one SVC l. To perform 
gapless I/O to a magnetic tape, a task must issue an SVC 1 call 
that specifies, among other things, a pair of buffer queues, the 
IN-QUEVUE and the OUT-QUEUE. The driver takes buffers from 
IN-QUEUE and returns used buffers to the OUT-QUEUE. The task 
processes the buffers from the OUT-QUEUE and returns these 
buffers to the IN-QUEUE for reuse by the driver. A special 
gapless format SVC 1 parameter block must be used for gapless I/0 
operations. Buffers used within a single gapless I/O operation 
must be equal in length, with the possible exception of the last 
buffer used. 


5.11 DISK STORAGE 


Perkin-Elmer disk devices support variable length records. 
During input, a current sector pointer is maintained. Ona 
sequential read, data is read into the user buffer from the disk, 
starting at the current sector, until the buffer is full. If an 
attempt is made to read beyond the end of the disk, end of medium 
(EOM) status is returned. On a random read request, data is read 
from the disk starting at the sector specified by the random 
sector address passed with the request, until the buffer is full. 
If an attempt is made to read beyond the end of the disk, EOM 
status is returned with data transferred. ASCII, binary, and 
image requests are identically treated. 


During output, data is written from the user buffer to the disk, 
starting at the current sector (for sequential writes) or at the 
specified sector (for random writes), until the buffer is empty. 
Attempts to write past the end of the disk cause EOM status to be 
returned. In this case, no data is transferred. 


Errors on data transfers cause the operation to be retried 
several times before returning error status. 


All data transfers start on a sector boundary, but can end on any 
byte of a sector. If the size of the user buffer is less’ than 
the record size of an indexed file to which it is written, the 
remaining bytes will be filled with blanks for ASCII writes or 
binary zeros for binary writes. If a record written to a 
contiguous, extendable contiguous, or nonbuffered indexed file is 
less than the file's record length, the last byte or two bytes 
are propagated through the remaining unfilled bytes of the last 
256-byte sector of the record. 


Only e-tasks and privileged u-tasks and d-tasks linked with bare 
disk privileges (OPTION DISC) can access a bare disk. 
Non-privileged u-tasks and d-tasks access the disk via the 
contiguous, extendable contiguous, nonbuffered indexed, or 
indexed file handlers. 
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5.12 FLOPPY DISK 


Variable length records are supported by Perkin-Elmer floppy 
disks. During input, a current sector pointer is maintained. On 
a sequential read, data is read from the disk starting at the 
current sector into the user buffer until the buffer is full. On 
a random request, the data is read from the disk starting at’ the 
sector specified by the random sector address passed with the 
request, until the buffer is full. If an attempt is made to read 
beyond the end of disk, EOM status is returned with data 
transferred. ASCII, binary, and image requests are identically 
treated. 


During output, data is written from the user buffer to the disk, 
starting at the current sector pointer (for sequential writes) or 
at the specified sector (for random writes), until the buffer is 
empty. If an attempt is made to write beyond the end of the 
disk, EOM status is returned with no data transferred. ASCII, 
binary, and image requests are identically treated. 


Errors on data transfers cause the operation to be retried ten 
times before returning error status. 


All data transfers start on a logical 256-byte sector boundary 
(two physical sectors on the floppy). Transfer can end on any 
byte of a sector. 


The floppy disk driver is designed for use by the file manager. 
A user program cannot access a bare disk unless it is an e-task 
Or privileged u-task or d-task linked with bare disk privileges 
(OPTION DISC). For nonprivileged u-tasks and d-tasks, the disk 
is accessed by the contiguous, extendable contiguous, nonbuffered 
indexed, or indexed file handlers. 


5.13 VIDEO DISPLAY UNIT (VDU) TERMINALS 


Variable length records are supported by all Perkin-Elmer VDU 
terminals. 


During non-VFC read ASCII operations, data read is masked to 
7-bit ASCII. Data is read until the buffer is full or a carriage 
return is encountered, whichever occurs first. Upon termination, 
a CR/LF sequence is sent to the screen. 


During non-VFC write ASCII operations, the buffer is scanned _ to 
eliminate trailing blanks. Data is then sent to the VDU until 
the buffer is exhausted, the last nonblank character has been 
processed, or until a carriage return is_ found in the data 
stream. A Line feed is automatically appended to the detected 
Carriage return; or, if no carriage return is detected, an LF/CR 
sequence is sent to the terminal. 
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During non-VFC image I/O, none of the above formatting actions 
occur. The amount of data requested is output or read in without 
masking to 7-bit ASCII, eliminating trailing blanks, checking for 
control characters, or detecting or appending carriage returns or 
line feeds. On image read, however, an ASCII CR is detected as 
an end of line sentinel. 


For information on I/O operations with VFC, see Section 5.2. See 
the OS/32 Operator Reference Manual for an explanation of the 
function control keys available on Perkin-Elmer VDU terminals. 


5.14 8-LINE INTERRUPT MODULE 


Interrupt simulation (SINT) is the only attribute supported by 
the Perkin-Elmer 8-line interrupt module. The module provides 
the processor with eight interrupt lines from external equipment 
and acknowledges interrupts on a priority basis. Any line can be 
selectively enabled or disabled. Several lines can _ be 
concurrently enabled. An interrupt does not transfer any data, 
nor is any status given. 


5.15 DIGITAL MULTIPLEXOR 


ASCII operations are not supported by the Perkin-Elmer digital 
multiplexor. During input, the second byte of the random address 
field contains the segment and point number to be read. Data is 
read from the point specified until the buffer specified by the 
starting and ending address is full. 


During output, the second byte of the random address field 
contains the segment and point number to be written to. Data is 
written until the buffer specified by the starting and ending 
address is exhausted. 


5.16 CONVERSION EQUIPMENT 


The analog conversion equipment used with Perkin-Elmer 32-bit 
computers cannot be programmed in the device independent manner 
of other peripheral devices. The chassis, channel and card 
addresses, and data values are directly passed to the real-time 
analog system controller as the 16-bit words that are obtained 
from the user. 


During input, the random address field of the SVC 1 parameter 
block contains the starting address of a table containing 
analog-to-digital converter addresses (chassis address, channel 
address, and card address). The user buffer, which the start and 
end addresses of the parameter block determine, is loaded with 
the digitized data obtained from these analog-to-digital 
converters. 
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The table length containing the converter addresses is equal to 
the length of the buffer. It is the user's responsibility to 
provide valid addresses. Since the analog input system mode of 
the controller is used for READ, if a nonexistent chassis is 
addressed, zero data is stored and no other indication is given. 


During output, the user buffer is assumed to contain sequential 
pairs of alternating digital-to-analog converter addresses and 
the corresponding data to be converted; i.e., ADD1, DATAl1, ADD2, 
DATAZ >a. sac hes ADDn, DATAn. The address and data are directly 
passed to the real-time analog system controller. 


The control outpuc mode of the controller is used for write 
operations. If a nonexistent chassis is addressed, the status is 
set to X'88', and the remainder of the I/O is aborted. 


Each write sequence to any converter must consist of two 
halfwords. One halfword specifies the adapter to do the 
conversion; the other halfword contains the data to be converted. 
A buffer must be a multiple of two halfwords' in length; 
otherwise, any attempt to do a write results in a memory fault. 


For read and write operations, ASCII/binary and image/format 
requests are identical. 


5.17 ANALOG INPUT CONTROLLER 


Variable record lengths are supported by the Perkin-Elmer analog 
input controller. ASCII operations are not supported. Command 
functions are ignored. 


The random address field of the supervisor call 1 (SVC 1) 
parameter block contains the gain and address’ of the first 
channel to be sampled. The format is shown in Figure 5-1. 
Dividing the length of the user buffer (END-START+1) by two 
determines the number of channels to sample. The digitized data 
is sequentially stored in the user buffer, one halfword per 
channel. 


me a i A TE A RD ee RN A a ee NN mS OY et orem ee 


H Gain H ! Address | 


SN ee ee ee ee ee 


Figure 5-1 Random Field Format 
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The driver accepts only random calls, meaning that the first 
address is selected at random and that further addresses are 
sequential (in the same call). The start address must be on an 
even address boundary and the end address must be on an _ odd 
address boundary, since the analog input controller is a halfword 
device. This complies with the Instrument Society of America 
(ISA) definition of sequential analog input. 


5.18 ANALOG OUTPUT CONTROLLER 


All command functions are ignored by the Perkin-Elmer analog 
output controller. One halfword of data is obtained from the 
user buffer in the format specified in Figure 5-2 and written to 
the device for conversion. This procedure is repeated until all 
halfwords in the user buffer are output. Dividing the length of 
the user buffer (END-START+1) by two computes the number of 
halfwords to be output. 


Ce eR Be ce ie date Maaetneetimatem i eiemdeen anda 


a ce meee EY ere Se ere me me eee meme NY ame ewes tee ee ems rm eee Seep ce me eee em rege eee ee ee eee ee nee ee ee ee ee 


Figure 5-2 Analog Output Data Format 


Binary image is treated identically to binary formatted; the 
image bit is ignored. The sequential/random bit is also ignored. 
The start address must be aligned on an even boundary, whereas 
the end address must’ be on an odd boundary because the analog 
output controller is a halfword device. 


5.19 DIGITAL INPUT/OUTPUT (DIO) CONTROLLER 


All command functions are ignored by the Perkin-Elmer DIO 
controller. The number of transfers is computed using the start 
and end address’7 fields: (END-START+t1)/2. Resetting the 
sequential/random bit in the function code field causes transfers 
to occur sequentially without interruption. This is a 
nonhandshaking transfer mode. In the handshaking transfer mode, 
the sequential/random bit is set, and each transfer occurs only 
after the internal strobe line is pulsed. A timeout rate for 
each transfer is set at a constant of four seconds. 


During a binary read operation, one halfword of data is 
transferred to the user buffer whose starting address is stored 
in the SVC 1 parameter block. Each halfword of data from 


subsequent binary read operations is stored sequentially in the 
user buffer. 
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For binary write operations, the buffer starting address in the 
SVC 1 parameter block points to a buffer (Kl) consisting of image 
halfwords for transfer to an output device. The random address 
field of the SVC 1 parameter block points to another buffer (K2) 
of halfwords designating masks, each of which defines’ the 
corresponding bit position of the halfwords in Kl that is to be 
changed. 


The length of K2 must be the same as that of Kl. A bit set in K2 
indicates that the digital output is changed to the state defined 
by the corresponding bit position in Kl. The following logical 
expression computes the halfwords transferred to the digital 
output card: 


(K10K2) + (K20R) 


Where: 
® means logical AND. 
® means logical OR. 
K2 means one's complement of K2. 
R is the last known content of the output 


register. 


Binary image is treated identically to binary formatted; the 
drive ignores the formatted/image bit of the SVC 1 function code. 
Both handshaking and nonhandshaking transfer modes are supported. 
The start and random addresses of the user buffer must be aligned 
to even boundaries, whereas the end address must be aligned to an 
odd boundary because the digital I/O controller is a halfword 
device. 
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CHAPTER 6 
PROGRAMMING IN A MODEL 3200MPS SYSTEM 
MULTIPROCESSING ENVIRONMENT 


6.1 INTRODUCTION 


Programming in a Model 3200MPS System multiprocessing environment 
is similar to programming in a_euniprocessing environment. 
However, due to the nature of the hardware configuration, the 
Model 3200MPS System environment offers one major programming 
advantage, increased throughput. For efficient use of this 
expanded computing ability, the system level programmer’ should 
take the following into consideration: 


e the selection of tasks that are to run on each processor. in 
the system at any given time, 


@e the assignment of processor units to the selected tasks, 


e the preparation of the auxiliary processing units (APUs) for 
task execution, 


e the rescheduling of tasks from one processor to another in 
response to a failure condition or processor overload, 


e the prevention of invalid data variables caused when two 
tasks, running on different processors concurrently, read and 
modify a common data structure, and 


@ the measurement of real-time performance of the _ individual 
tasks in the system. 


This chapter focuses on some techniques that can be used by an 
assembly language programmer in solving some of the programming 
problems that are unique to the Model 3200MPS System 
multiprocessing environment. 


6.2 DESIGNING TASKS TO RUN ON A MULTIPROCESSING SYSTEM 


The main performance advantage of designing an application to run 
on a multiprocessing system is that a job can be broken down into 
several parts that can be run on different processors 
simultaneously. For example, a job can be divided among a number 
of tasks that control individual operations, such as process 
input/output (1/0), perform calculations resulting from a 
particular action, and provide an operator interface for 
reporting and responding to the results of the calculations. 
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The individual APUs running these tasks can transmit all status 
information regarding the components) of the system to another 
task, called the supervisor monitor. The supervisor monitor’ can 
then output messages to a console or printer as the status is 
received. Another function of the supervisor monitor could be to 
store a code in a status word in memory that can be accessed by 
a standby task. The standby task then would be able to 
periodically check the status of the system and adjust task 
execution accordingly. 


Once the programmer has divided a job into several tasks that can 
be run simultaneously, the next step should be to assign each 
task to a processor for execution. It should be remembered that 
execution of a compute-intensive task on an APU increases overall 
system performance, while an I/O intensive task running on an APU 
decreases system performance. Because the operating system 
executes exclusively on the central processing unit (CPU), each . 
I/O request made by an APU task causes the task's execution to be 
transferred back to the CPU for operating system suppport. 
Hence, all I/O intensive tasks should be assigned to the CPU for 
execution. 


6.3 ASSIGNING A TASK TO A PROCESSOR 


OS/32 supports a multiprocessing configuration consisting of one 
CPU and one to nine APUs. Each processor is given a unique 
identifying number. By definition, the identifying number for 
the CPU is zero. APUs are numbered from one through nine. 


The operating system also defines a set of logical processing 
units (LPUs). An LPU is mapped to an APU or to the CPU. An APU 
can be mapped to more than one LPU, but each LPU can be mapped to 
one and only one APU. The identification number of the processor 
to which each LPU is mapped is contained in a system data 
structure known asthe logical processor mapping table (LPMT). 
Before a task can run on an APU, the task must be assigned to an 
LPU that is mapped to the processor. (If the LPU is mapped to 
APU O, the task will execute on the CPU.) 


As in a uniprocessor system, a task can load another task for 
execution on an APU via supervisor call 6 (SVC 6). Unlike a 
uniprocessor system, however, the programmer must consider two 
additional SVC 6 function codes, assign LPU (SFUN.LPM) and 
transfer to LPU (SFUN.XLM). These function codes assign the task 
to an LPU and transfer execution from the CPU to the APU mapped 
to the assigned LPU. 


The following example shows how to code an SVC 6 parameter block 
for sending a task to the APU assigned to LPU 2. It is assumed 
that logical unit 5 (lu5) has been assigned to the file 
DIRECTED.TSK (via the OS/32 ASSIGN command or an SVC 7) and is 
positioned to the first byte of the LIB for the task, and that 
LPU 2 has been mapped to an APU. 
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* kkk kK IO OUI KOO KOKO KOO OOO KK KO 


x x 
- This example loads and starts a copy of a task to * 
” run on an APU in a Model 3200MPS System. . 
x * 
sO ROR KOK OOO kK ko OK OOOO OOK OKO OO KK KOK KKK KKK 
$SVC6 
ALIGN 4 
PARBLK ODS SVC6 ALLOCATE STORAGE FOR PARBLK 


ENDBLK EQU * . 
*SET LOAD, ASSIGN LPU, LPU-DIRECTED, & START FUNC CODES 
ORG PARBLK+SVC6 .FUN 


DC SFUN.DOM!SFUN.LM!SFUN.LPM! SRUN.XLM!SFUN.SIM 
ORG  PARBLK+SVC6.LU 
DB 5 LU OF DIRECTED.TSK (IMAGE) 
ORG  PARBLK+SVC6.SAD 
Dc 0 TASK EXECUTION START ADDR 
ORG PARBLK+SVC6.SOP 
DC fy) START OPTIONS (none) 
ORG PARBLK+SVC6.SEG 
DC Y¥'40' TASK WORKSPACE 
ORG  ENDBLK 
START EQU * 
*SETUP NAME OF TASK TO BE LOADED 
LI R1, CAPUL 
ST Rl, PARBLK 
LI R1,C' TASK’ 


ST Rl, PARBLK+4 
*ASSIGN LPU NUMBER 

LIS R1,2 

STB R1, PARBLK+tSVC6 .LPU 
*ISSUE SVC6 TO LOAD TASK FROM LU5 

SVC 6, PARBLK 

END START 


After the SVC 6 in the above example is executed, the task will 
be loaded into memory from the file (DIRECTED.TSK) with a 
workspace of 640 (X'40') bytes. When the task is loaded, the 
task manager dispatches it to the APU mapped into APU 2. 


NOTE 


If the LPU-directed function code 
(SFUN.XLM) was not set, the task is 
executed on the CPU. If the task was 
linked with the APU-only (APUONLY) task 
option, the task is not dispatched to an 
APU and pauses. 


For more information on SVC 6, see the OS/32 Supervisor Call 
(SVC) Reference Manual. 
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6.4 PREPARING AN AUXILIARY PROCESSING UNIT (APU) FOR TASK 
EXECUTION 


Even though a task is assigned to an LPU mapped to an APU, the 
task will not be dispatched to the APU unless the APU is ina 
valid task operating state. OS/32 maintains four operating 
states for an APU, each differing in the degree of APU readiness 
for task execution. These states are: 


e DISABI.ED - APU is unavailable for all purposes except running 
the power up link check procedure. (An APU is placed in the 
DISABI.ED state upon loading of the operating system or power 
restore. ) 


e OFF (ENABLED) - APU has successfully passed the power up link 
check procedure but is not available for task execution. 


e ON EXCLUSIVE - APU is available for scheduling and executing 
a Single designated task only. 


e ON - APU is fully available for scheduling and executing any 
task in the system. 


Figure 6-1 shows the valid APU operating states. A task can 
control the task operating state of an APU by executing the 
corresponding SVC 13 APU control and mapping functions. The SVC 
13. APU control functions are used by a task to enable or disable 
an APU. The SVC 13 mapping functions are used to mark the APU on 
for task scheduling and to map the APU to a particular LPU number 
in the LPMT. 
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Figure 6-1 Valid APU Operating States 


The following code demonstrates how SVC 13 is used to enable an 
APU and mark it on for task scheduling. This example does not 
check for SVC 13 execution errors. 


Example: 


ENABLE 
ENABLEE 


$SVC13 
ALIGN 4 
DS SVC13 ALLOCATE STORAGE FOR SVC 13 PARBLK 
EQU- * 


*GAIN CONTROL RIGHTS, ENABLE APU, SEND APU COMMAND, AND ‘ 
*RELEASE CONTROL RIGHTS 


ORG ENABLE+SV13 .OPT 


DB X'C9' 

ORG ENABLE+SV13 .FUN 

DB X'03' FUNCTION CODE=3 

ORG ENABLE+SV13 .DOP 

DB X'O1' SEND START APU COMMAND 


ORG ENABLE+SV13 .APN 
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DB 2 APU NUMBER 
ORG ENABLED 
***BUILD SVC 13 PARAMETER BLOCK FOR MAPPING APU 


ALIGN 4 
MAP DS svcl3. ALLOCATE STORAGE FOR SVC 13 PARBLK 
MAPE EQU * 


*GAIN MAPPING RIGHTS, MARK APU ON, MAP APU INTO LPMT, 
*RELEASE MAPPING RIGHTS 
ORG MAP+SV13 .OPT 


DB X'Bl1' 
ORG MAP+SV13.FUN 
DB 2 FUNCTION CODE=2 
ORG MAP +SV13 .DOP 
DB 2 LPU NUMBER TO BE MAPPED 
ORG MAP+SV13.APN 
DB i’ APU TO MAP LPU TO 
ORG MAPE 
**&*k*K*KXTSSUE SVC 13 TO ENABLE AND MAP APU****xxx 
SVC 13, ENABLE ENABLE APU 
SVC 13 ,MAP MAP APU TO LPU 2 


6.5 TASK RESCHEDULING 


In a uniprocessor system, priority scheduling determines’ the 
execution flow of the tasks in the system. In order to affect 
task scheduling, a programmer must change the priority of the 
tasks in the system. In an OS/32 Model 3200MPS multiprocessing 
system, this is only true for tasks that are running on the CPU. 
Rescheduling tasks on an APU is’ accomplished via the SVC 13 
control function options, as described in the following sections. 


6.5.1 Monitoring and Preempting Auxiliary Processing Unit 
(APU) Task Execution 


This section will examine the methods used by an APU monitor task 
to: 


e receive status signals from an APU, and 


@® preempt the current task executing on an APU with another task 
after a certain time interval has elapsed. 


To receive a status signal from an APU, the APU must be connected 
and thawed (via SVC 6) as a trap-generating device to the monitor 
task. In addition, the monitor task must have the appropriate 
bits in its task status word (TSW) set, a task queue to receive 
the status signal, and a task queue trap handling routine to 
service the trap. The following example demonstrates how to code 
a typical APU monitor program to receive and handle task queue 
traps from an APU. For more information on task trap handling 
see the 0S/32 Application Level Programmer Reference Manual. 


6-6 48-040 FOO RO2 


Example: 


xxxk Define a task queue to receive APU signals ****kkKkKKKKKA KE 
* * 
ALIGN 4 
TASKQ DLIST 100 DEFINE TASK Q OF 100 ELEMENTS. 


* 


Put the address of task queue in UDL (UDL.TSKQ) 


e 


LA R14, TASKQ 
ST R14,UDL.TSKQ 


x x 
* Set TSW bits to enable the applicable task traps. . 
x . x 
LI R14,TSW.TSKM+TSW.APTM 
x * 
* TSW.TSKM enables task queue service traps x 
* TSW.APTM enables signals from APU x 
* Save TSW values to enable APU signals and task Q entries x 
ST R14,ENTRIES SAVE TSW VALUES 
* TO ENABLE APU SIGNALS AND TASK Q ENTRIES 
x x 
* SET UP TSW FOR TRAPS IN UDL id 
x x 
LA R15,QSERVICE 
STM R14,UDL.TSKN SET UP TSW ON TRAPS IN UDL 
SVC 9 ENABLE TASK QUEUE ENTRIES 


For information on writing a task queue trap handling routine 
that removes the APU status entries from the task queue, see the 
OS/32 Application Level Programmer Reference Manual. 


The following code demonstrates a method of connecting the APUs 
in a system as trap-generating devices to the APU monitor task. 


Example: 
* Enable each APU in the system if it is not enabled and then n 
* connect to each APU, but first a 
* fetch a copy of the LPMT to obtain the & 
* number of APUs in the system. - 
x x 
START svc 13, LPMTFET 
LB Rl, BUFFER1+1 LOAD MAX APU NO.INTO Rl 
* SET UP SVC 13 PARAMETER BLOCK TO a 
* FETCH APU STATUS * 
LIS R3,1 
STB R3,FETAPU+SV13.FUN SET UP FUNCTION CODE 1 
LA R4,APUBUF . 
ST R4,FETAPU+SV13.BUF SET UP BUFFER ADDR. . 


48-040 FOO RO2 6-7 


LHI R3,256 
STH R3,FETAPU+SV13.LEN SET UP BUFFER LENGTH 


x * 
* SET UP SVC13 PARAMETER BLOCK TO ENABLE THE APU x 
x x 
LIS R3,3 SET UP SVC 13 FUNC CODE 3 
STB R3,ENABAPU+SV13.FUN 
LIS  R3,X'CL' SET UP CONTROL OPTIONS 
STB  R3,ENABAPU+SV13.OPT GAIN, ENABLE, RELEASE 
x x 
* GET THE APU STATUS. IF APU IS DISABLED, x 
* ATTEMPT TO ENABLE IT. IF APU CAN'T BE x 
x ENABLED, LOG MESSAGE TO CONSOLE AND * 
* CONNECT TO IT ANYWAY JUST IN CASE IT IS x 
* ENABLED AND MARKED ON LATER. x 
x * 
APULOOP EQU * 
* GET APU STATUS 
STB R1,FETAPU+SV13.APN SET UP APU NO. 
SVC 13, FETAPU ISSUE SVC 13 
LH R4,FETAPU+SV13.ERR GET SVC 13 ERROR STATUS 
BZ GETSTAT IF NO ERROR-GET APU STATUS 
BNE  ER.ROUTE IF ERROR, BRANCH TO ER.ROUT 
LB R5,APUBUF +5 GET 2ND BYTE OF APU S-STATUS 
BNZ CONNECT NOT DISABLED, GO CONNECT 
*APU IS DISABLED; ISSUE SVC 13 TO ENABLE IT. 
STB  R1,ENABAPU+SV13.APU SAVE APU NUMBER 
SVC 13,ENABAPU ENABLE THE APU 
LH R3,ENABAPU+SV13.ERR GET SVC 13 ERROR STATUS 
BNZ ENAB.ERR BRANCH TO ERROR ROUTINE ON ERROR 
CONNECT EQU * 
x x 
*SAVE APU NO. AS PART OF APU'S TGD MNEMONIC x 
STB R1,SVC6.DEV 
x*ISSUE SVC6 TO CONNECT AND THAW THE APU * 
x x 
SVC 6,APUTRAPS 
LH R6,SVC6.STA GET SVC 6 ERROR STATUS 
BZ NEXT. APU NO ERROR-GO CONNECT TO NEXT 
x APU 
STB R1,CONB.ERR+24 SAVE APU NO. IN MESSAGE 
SVC 2,LOGMSG LOG MESSAGE: COULD NOT 
x CONNECT TO APUX 
NEXT.APU SIS R1,1l MOVE ON TO NEXT LOWEST APU NO. 
BP APULOOP GO HANDLE NEXT APU. 


The parameter blocks used in the above example are defined as 
follows: 


*SVC 13 FETCH LPMT Parameter Block and Buffer 
ALIGN 4 

LPMCFET DS SVC13 

ENDPBK EQU * 
ORG LPMTFET+SV13 .FUN 
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DB X‘'OO' SET FUNC CODE 0 
ORG LPMTFET+SV13 . BUF 


DAC BUFFER 1 DATA BUFFER ADDR 

ORG LPMTFET+tSV13 .LEN 

DC H'50' MAX LENGTH OF BUFF 

ORG ENDPBK 

ALIGN 4 
BUFFER DS. 50 
x x 
* SVC13 Fetch APU Status Parameter Block & Buffer - 
* ALIGN 4 x 


* FETAPU DS SVC13 


ALIGN 4 
APUBUF DS 256 


x 
*x* SVC13 Enable APU Parameter Block 
* 


ALIGN 4 
ENABAPU DS SVC13. 
x 


* 


* SVC 6 Connect & Thaw APU Parameter Block 
x x 
$SVC6 
ALIGN 4 
APUTRAPS DS SVC6. 
ENDAPUTB EQU - 
ORG APUTRAPS+SVC6.FUN 
DS ¥'cO000 COO00' SVC6 FUNC CODE- 
. SELF-DIRECTED, CONNECT & THAW 


ORG APUTRAPS+SVC6 .DEV 
DC C'APU' TRAP-GENERATING DEVICE MNEMONIC 
ORG ENDAPUTB 


x 
xxx* SVC 2 Log Message Parameter Block 
x 


LOGMSG DB 0,7 

DCZ CONE . ERR-CONB .ERR 
CONB.ERR DB C'UNABLE TO CONNECT TO APU‘ 
CONE.ERR EQU = 


The code in the above example allows the monitor to receive traps 
from the APUs. Status returned from these traps can be reported 
to the console (via SVC 1 or SVC 2 Code 7) or toa file 
designated for the APU output (via SVC 1). In addition, this 
monitor program could be coded to run a certain task (TASK1) 
every 10 minutes on a specific APU. To do this, the monitor sets 
an interval timer via SVC 2 Code 23. Upon expiration of the 
timer, the monitor task issues an SVC 13 Code 3 to preempt the 
current executing task on the APU, as shown beiow. 
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Example: 


SVC 13, PREQ 


ALIGN 4 


* PREEMPT QUEUE, EXECUTE CONTROL COMMAND, AND RELEASE CONTROL RIGHTS 

PREQ.OPT DB X'B9' SET SVC 13 OPTIONS: 

PREQ.FUN DB X'0O3' SET FUNCTION CODE- 

= CONTROL FUNCTION 

PREQ.DOP DB X'O1' DIRECTIVE OPTION- 

i START A 

PREQ.APN DB X'O1' APU NO. - APU 1 

PREQ.APS DS 2 APU HARDWARE STATUS 

PREQ.ERR DS 2 SVC 13 ERROR STATUS 

PREQ.BUF DAC BUF 2 DATA BUFFER ADDRESS 

PREQ.USE DS 2 . LENGTH OF BUFFER USED 

PREQ.LEN DC H'8' MAX LENGTH OF BUFFER 
ALIGN 4 

BUF 2 DC C'TASK1 bpp' TASK ID BUFFER 


Execution of the above SVC 13 will cause the monitor to gain 
control rights to the specified APU (APU 1), provided that the 
task has been link edited with the APCONTROL task option and _ no 
other task has control rights to the APU. The control options, 
specified in the SVC 13 parameter block, will then cause the 
following actions: 


e Execution of the current executing task on the APU will be 
stopped. 


e The current task will be rescheduled to the end of the APU 
ready queue. 


e The APU's ready queue pointer will be repositioned to point to 
TASK1L. (This will cause TASK1 to be selected as the next task 
to be executed on the APU.) 

e The APU will be restarted for execution of TASK1. 

e The monitor task will release the control rights to the APU. 


The remaining code in the monitor program should check the 
PREQ.ERR field of the PREQ parameter block for errors as follows: 


Example: : 


IH R2,SV13.ERR 
BNZ ERR. PREQ 
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If an error has occurred, ERR.PREQ can log a message to the 
console. 


Finally, to reexecute TASK1 in 10 minutes, the interval timer 
(via SVC 2 Code 23) should be reset so that the SVC 13 Code 3 to 
preempt the current APU task can be reissued when 10 minutes have 
elapsed. 


See Chapter 3 for more information on svc 13. See the 0OS/32 
Supervisor Call (SVC) Reference Manual for more information on 
SVC 6 and SVC 2 Code 23. 


6.5.2 Verifying Task Transfer to an Auxiliary Processing Unit 
(APU) 


It may be necessary for a task to verify whether or not it has 
actually been transferred to an APU for processing. For example, 
suppose a task on the CPU is assigned to LPU 3 and executes the 
following instruction: 


RSCH R1,2 


Execution of this instruction will cause OS/32 to set the LPU 
directed status of the task. The OS/32 task manager will then 
attempt to transfer the task to the APU mapped to LPU 3. Suppose 
ILPU 3 is mapped to APU 3. To verify that the task has_ indeed 
been transferred to APU 3, the next instructions executed by the 
task could be: 


LIS R1,0 Get RTSM PULSE LINE 
* TO PULSE 

Ll R2,15 FILL IN APU ID 

GSIG R1,R2 GENERATE SIGNAL 


* HERE THE NO. (15) CAN NEVER MATCH 
THE APU ID IN THE RTSM. NO SIGNAL WILL BE 
SENT. INSTEAD, ONLY THE APU ID IS RETURNED TO Rl 


e 


After execution of GSIG, Rl will contain the number of the APU on 
which the task is currently executing. See the Model 3200MPS 
System Instruction Set Reference Manual for more information on 
the RSCH and GSIG instructions. 
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6.5.3 Transferring a Task from an Auxiliary Processing Unit 
(APU) to the Central Processing Unit (CPU) 


Under certain conditions, a monitor task may need to transfer 
some other task back to the CPU for processing. The task to be 
transferred may be executing on an APU or waiting on its ready 
queue. The monitor task can transfer a task back to the CPU by 
issuing an SVC 6, specifying the following function codes: 


e Suspend (SFUN.SM) 

e Set CPU directed (SFUN.XCM) 

e Release (SFUN.RM) 

The suspend will transfer the task back to the CPU by setting the 


CPU directed flag. Upon release, it will stay on the CPU and not 
be dispatched back to the LPU. 


Example: 
SVC 6,CPUDIR 
ALIGN 4 
$SVC6 
CPUDIR DS SVC6. 


CPUDIRE EQU * 
ORG CPUDIR+SVC6.ID 
DC C'TASK1 ppp ' ID OF TASK TO BE 
* TRANSFERRED 
ORG CPUDIR+SVC6.FUN 
* SET SUSPEND,CPU-DIRECTED, & RELEASE FUNC CODES 
* FOR TASK1 
DB SFUN .DOM!SFUN .SM!SFUN .XCM!SFUN. RM 
ORG CPUDIRE 


Execution of this SVC 6 causes TASK1 to be suspended (if it is 
not already in a wait state) and transferred to the CPU. Setting 
the CPU directed bit in the task's TSW directs the task manager 
to ignore its LPU assignment and to schedule this task for 
execution on the CPU. When released, the task will execute on 
the CPU at the location following the instruction that was 
executed before the task was suspended. If the SVC 6 in the 
above example did not set the CPU directed bit in the task'‘'s TSW, 
the task will again be dispatched to the APU assigned to its LPU 
number upon release from the suspended state. 
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6.6 PREVENTING MEMORY ACCESS CONFLICTS 


When several processors are executing simultaneously, it is 
possible for tasks running on_ two or more processors to need 
access to the same data. For example, suppose two tasks share a 
buffer list consisting of 30 buffers defined as follows: 


BLISTBIT DS 2 
BUFLIST DLIST 30 


BUFLIST is a list containing the addresses of the buffers. 
BUFLIST, and the actual buffers, reside in an area of memory 
shared by the two tasks. One task collects data, writes it to a 
buffer and adds the address of that buffer to the bottom of the 
list. The other task removes an address of a buffer from the top 
of the list and processes it. Since in a Model 3200MPS System 
both tasks may be running simultaneously on different APUs, both 
tasks may attempt to access the list at the same time. The Test 
and Set instruction (TS) can be used to ensure that only one task 
can access the buffer at a time. 


To ensure that only one task can access BUFLIST at a time, a test 
and set operation is performed on BLISTBIT. BLISTBIT acts as a 
lock out mechanism that is set and reset. A task can only access 
BUFLIST if BLISTBIT is not set. 


6.6.1 Avoiding System Deadlock 


When using the test and set operation, care should be taken to 
ensure that system deadlock is avoided. 


For example, suppose task A uses TS to lock out data structure X 
while task B is locking out data structure Y. Task A now finds 
that it needs to access data structure Y, so it waits for Y to be 
released. Similarly, Task B finds it needs to access data 
structure xX, so it waits for X to be released. Since each task 
holds the data structure needed by the other, processing’ stops. 
Both tasks are deadlocked. 


To avoid system deadlock, the test and set instruction should be 


used with a timeout mechanism. The following example shows how 
to prevent memory access conflicts without system deadlock. 
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Example: 


TS BLISTBIT TASK CHECKS IF IT CAN GET 
x ACCESS TO LIST 

BNM CONTINUE PROCESS LIST IF FREE 

LI R2,50 LOAD TIMEOUT VALUE OF 50 
* MICROSEC IN R2 
SETBITLP EQU * TIMER ROUTINE 

SIS R2,1 DECREMENT TIMEOUT COUNT 

BM TIMEOUT BRANCH TO TIMEOUT ROUTINE 
*IF BRANCH TO TIMEOUT IS TAKEN IT MEANS THAT THE x 
*TASK STILL COULD NOT GET ACCESS TO LIST x 
*THE TIMEOUT ROUTINE PRINTS A MESSAGE TO THE CONSOLE x 
*SO OPERATOR CAN TAKE NECESSARY ACTION x 
*ELSE CONTINUE x 

LH R4,BLISTBIT USE APU CACHE TO MATCH LOCKS 

BMS SETBITLP BUFLIST NOT AVAILABLE YET; 
x TRY AGAIN 

TS BLISTBIT BUFLIST IS AVAILABI.E SO 
x ATTEMPT TO GRAB ACCESS 

BMS SETBITLP NOT QUICK ENOUGH, RETRY 
**IF SUCCESSFUL, PROCESS LIST xx 
x x 
CONTINUE EQU) * 
* i * 
x x 
x . x 
*ACCESS BUFLIST EITHER BY ABL (ADD TO BOTTOM OF LIST x 
*INSTRUCTION) OR RTL (REMOVE FROM TOP OF LIST INSTRUCTION). * 
x x 
x x 
* J x 
*AFTER PROCESSING BUFFER, UNLOCK BLISTBIT SO OTHER TASK CAN x 
*ACCESS IT. x 
x x 


LIS R4,0 
RBT R4,BLISTBIT 


6.7 MEASURING REAL-TIME PERFORMANCE ON A MODEL 3200MPS SYSTEM 


The OS/32 system macro library provides a set of timer macros 
that can be used to measure the real-time performance of 
individual tasks running in a Model 3200MPS System. These macros 
allow the programmer to set up a named timer in memory. A _ named 
timer can be compared to a stopwatch that measures the amount of 
time elapsed from the time the watch is started to the time it is 
stopped. The following example shows the data structure set up 
in memory for a timer named TIMRNAME. The timer macro, CRTIMERS, 
is used to set up timer data areas. 
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Example: 


ALIGN 4 
TIMRNAME DCF C'TIMRNAME ' TIMER NAME (8 CHAR MAX) 
DCF 0 TIMER COUNTER 
DCF 0 TIMER START VALUE 
DCF 0 ACCUMULATED TIME 
DCF 0 REGISTER SAVE AREA 


The timer macros are used to set the watch and read the 
accumulated time after a specified interval has elapsed. The 
timer macros are listed in Table 6-1. 


TABLE 6-1 TIMER MACROS 


Leela lh ce cement nie ce Rael eo ol re eee Bo ee ee oe anne ene n ne eee ee 


MACRO H FUNCTION 


CRTIMERS (NAMEL{ ,NAME2,...1) | Creates a data area for each 
i; named timer. 


rt nel ee eel cereal en Elcom el ce el eee ete ee ee ae ee meena ee ee ee ee a en ee ieee eee he ee oe ee ate nstatl co ocean insane tenet eet neiemtenatantinn linens 


ee cme em wm tem ree mem amet DRT rue ERS YS sem nn SRD gem eps ces emer mes crm oe ee mmm seem SU ee meee ems eee ees eee wee Se nm re mn em eee ee cen Re 


} Gets the total time accumulated 
i by the named timer. 


A Te MANS EY reves Sa ED aren a a Ge mY gs eg me es ee ee eee ee ee wee eee ee re eee me ee cee ee ee one ee 


|} Gets the number of intervals 
; that have been timed by this 
i timer. 


SS ee SE rea AE I AED ONE OEY US rene EEE SE EN mE GEE SH ee GE SEND ORME memes ene SEED SUE a UE we SSE me ree ete meh une me iene emer ene ee me rr eet oem am seme in mtn rum rem 


A Th cr at SEF ME mehr SG REN RO em Se eel neh EP cemn mtm eme SEED eeey rey MR es mS Seem em Sr ate em meer Seve mem eiee OD um mY ROE meme eS Se et UA neem ee aE IE ry mmm eee me 


The following example demonstrates how these macros can be used 
to time the execution of a program and its subroutine. 


Example: 


* Create a data area for the timer * 
* for MAIN and the timer for SUB 
* 


* 


CRTIMERS (MAIN,SUB) 


a *& 
* 


Start timer for MAIN. 


* 
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START EQU * 


STRTIME MAIN 


BAL R15 ,SUBPROG 


Stop timer for MAIN 

STOPTIME MAIN 
Get total time accumulated by MAIN 
Timer. Load into REG 0 

GETIME MAIN, RO 


Log MAIN program execution time. 


Get total time accumulated by SUB 


* timer. Load into REG 3 


GETIME SUB,R3 


* Get number of intervals timed by 
* SUB timer. Load into RO 


READTCNT SUB,RO 


Compute average subroutine execution 
time. 
DR R2,RO 


SUBPROG EQU- * 
x 


x 
x 


Start timer for SUB 
STRTIME SUB 
Stop timer for SUB 


STOPTIME SUB 
BR R15 


Detailed descriptions of the timer macros can be 
OS/32 System Macro Library Reference Manual. 


4 6 6 6 H HH He eH MH 


* 


+ &@ & MH 


found in the 
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6.8 WHERE TO GO FOR MORE INFORMATION 


This chapter is intended to demonstrate assembly language 
programming techniques used in designing system level control 
programs that take advantage of the Model 3200MPS System 


multiprocessing capabilites. However, all the programming 
facilities available for writing system level control programs 
are not shown. Table 6-2 summarizes additional facilities and 


lists the manuals in which they are described. 


TABLE 6-2 ADDITIONAL INFORMATION SOURCES FOR 
MODEL 3200MPS SYSTEM PROGRAMMING 


MANUAL PROGRAMMING METHODS peo H 


Model 3200MPS System This manual describes the machine H 
Instruction Set instructions specific to the Model 1 
t 
’ 
i 


Reference Manual 3200MPS System processor. It also 
gives a detailed discussion of the 
APU processor states. 
‘ie: ‘eS Se eam ei ae iis, Sm i ‘i'n ai a: Fa Sinn ih. ‘inp. Sh‘ ms: Sei tl: eg, ian ak sel ek cee ea ae H 
FORTRAN VII User Guide {| This manual describes the } 
Perkin-Elmer FORTRAN VII run-time 
library (RTL) routines available | 
for writing a FORTRAN system level i 
{ 
: 
} 


Bie Sate ates 
we eee we ee I] we 


i 
} control program that performs the 
} functions described in this chapter. 


Cael cae etal cael an et lee anne een ee el eh eee ne nia cee Ree ee ee a Re ae ee ne ie eee cee ee at ne cee cae ieee an hat enn aa ae cc te en ee en ad 


0S/32 Operator 
Reference Manual 


we we we we we we woe 


; This manual describes the operator } 
; commands that can be used to write a } 
i; command substitution system (CSS) H 
} command file to perform SVC 13 

} Mapping and control functions. i 
Ne ee a a ene } 
OS/32 Supervisor ;} This manual gives more details on | 
Call (SVC) Reference | how to use SVC 6, SVC 2 code 23, and };} 
Manual } assembly language PEOgrE aman: SVCs. 1 
ee a, ess ees ‘eke. es, eS: coun cme ss Sun: oem re erm cn ese um i ony een “eres “cum. oem meen ec ees (0 fem, enn. cemy ‘nas, com Seem jeer see’ Snes, ween ruse. cme mum psy mem rs) eet, im Ss ib ne ip hee ening Sits: Se” H 
OS/32 System Macro i This manual describes the timer and | 
Library Reference } SvC 13 macros. ' 
Manual H H 


ant ant nacelle nee icone eel ncaa enlace mee eed tenn ee ceee meee in eae tiene ee ene een ana ane ee ee en ene need eee a are ce ee re ce eee ne ee er ee 
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APPENDIX A 
0S/32 SUPPORTED INPUT/OUTPUT (1/0) DEVICES 
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femme Oc ee ee ee ee ee ee 
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ie eee my FE RENE TD Ses me i ee ae ee ee me ED wR oe we tee eR oe me weep crm ape ee me wee vam wee em ee ree er Pee ee me ee mem ee 


= 


ATTRIBUTES 


DEVICE 


TYPE 


Ml ~ | 


fi w= 


! 
! 
fi ----— | 
i 
l 
i 


75 ips, 


9-track, 


Continued) 


M 
t 
( 


* 


45 ips, 


-track, 
00/1600 bpi 


Oe 


45 ips, 


9-track, 


* 


x 


45 ips, 


-track, 
600 bpi 


Ac 


! 
! 
} 
: 
i 
! 
! 
' 
t 
| 
1 
1 
! 
| 
| 
i 
i 
| 
i 
H 
i 
I 
I 
I 
I 
! 
| 
i 
1 
I 
| 
| 
I 
| 
l 
{ 
I 
I 
! 
1 
| 
1 
| 
1 
1 
I 
! 
| 
! 
I 
! 


1.5Mb HPT disk 


Disks 


| 
I 
! 
! 
! 
{ 
{ 
1 
} 
I 
{ 
I 
} 
! 
! 
! 
1 
1 
| 
| 
! 
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.5Mb moving head 
removable 


isk, 


2 
d 


I 
| 
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! 
! 
I 
I 
! 
I 
t 
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I 
I 
J 
! 
I 
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| 
i 
! 
i 
! 
{ 
{ 
j 
| 
{ 
{ 
I 
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ra 


-5Mb moving head 
fixed 


isk, 


2 
d 


| 
{ 
' 
H 
| 
I 
I 
I 
i 
I 
| 
! 
! 
t 
! 
! 
t 
! 
! 
! 
\ 
! 
I 
I 
! 
| 
I 
I 
! 
t 
I 
{ 
| 
I 
I 
| 
I 
I 


OMb moving head 
isk (5Mb fixed, 


emovable) 


1 
d 
r 


I 
! 
{ 
{ 
! 
! 


OMb moving head 
isk, removable 


4 
d 


i 
! 


| 
! 
I 
i 
I 
I 
t 
! 
! 
t 
J 
| 
! 
1 
t 
{ 
I 
| 
I 
I 
t 
I 
! 
! 
| 
t 
{ 
I 
t 
! 
{ 
| 
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fixed 


67Mb disk, 


| 
t 
i 
j 
| 
j 
1 
! 
i 
! 
I 
! 
| 
| 
t 
! 
! 
t 
! 
i 
t 
1 
I 
| 
I 
{ 
! 
! 
! 
I 
! 
{ 
| 
! 
I 
t 
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remov— 


67Mb disk, 


able 


fixed 


160Mb disk, 


{ 


* 


wa am 


x 


emovable 


56Mb- disk, 


2 
r 


! 


xixixix} xix) 


fixed 


256Mb disk, 


xixix{ixixix] 


fixed 


675Mb disk, 


68 .6Mb 


| 
| 
i 
! 
: 
i 
| 
! 
I 
i 
i 
I 
! 
| 
i 
I 
| 
| 
! 
t 
i 
| 
I 
I 
l 
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I 
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t 
I 
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MSM 300 disk sys- 
tem (256Mb format- 


we meee eee meee mew meee meme ee wre re ee wee ee em ee ee eee ee ee ee ee ee ee eee 


SM 80 disk system 
67Mb formatted) 


== 


woes ewe woe eee eam eae wa eee ew eae eam tea wwe rae eae wee cee ee eee ere we ee em oe ere eae wae wea eee erer cea eee wee awa eee ere ee eee eee erm ee eee eee 
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iWiR 
ITISIN | TID} 


IRiIT{I{AIN 


DEVICE 


TYPE 
isks 


MSM 80F disk 
system 


Cont inued ) 


Qw~ 


MSM 80F/HPT disk 
system 
anguard 1 car- 
ridge disk system 


V 
t 


| Nonediting VDU $ A 


Video 


raphic display 
erminals $ A 


G 
c 


display 


xix} 


upplied external 


Model 1100 VDU §$ A 
8-line interrupt 
Digital multiplex- 
or controller 
Real-time analog 
system with 
internal clock 
Real-time analog 
ystem with user 
lock 


Floppy disk 


8 
Ss 
Cc 


Floppy disk 
8-line 
interrupt 
module 
Digital 
mult iplexor 
Conversion 
equipment 
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ATTRIBUTES H 
i 


! 
| | eel 
! iW) iBiW/RIFIT}H! 
| (RIRITIIVAIN{LING Li 
§ 


TYPE H DEVICE IDITISINITIDIPiT{T} 
§ SSS eS Se ee a ee ee Se ee ee Se ee ee ee ee ee ee 
Analog I/O ;{ Analog input ;ttetdodbeototot 
controller { controller ixt 4. boekxbeed + 4 4 

i] 


i Analog output i 4 
i controller i ot 


x 
We et ae ry Cet toe ay OE ee ee Wee eee See hte Near Oa ata yee ! 
| Digital I/O | Digital I/O and; Pio db dot ot db bob 
; controller {| analog output ae es es SESE 
|} system rXiX} tXIXIX) Fogoa 

LEGEND 

* CLI - Current loop interface 

A CLCM - Current loop communications multiplexor 

$ RS232C 

ATTRIBUTES 

RD READ 

WRT WRITE 

TS TEST & SET 

BIN BINARY 

WAT WAIT 


RND RANDOM 

FLP FILE POSITION 
INT INTERACTIVE 
HLT HALT 1/0 
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APPENDIX B 
SUPPORTED VERTICAL FORMS CONTROL (VFC) CHARACTER SET 


OPERATIONS AFFECTING 


X}| CHAR LINE SPACING 
HT | Horizontal tab 


i 
= 
| Set vertical tabs 
i (EVFU, no print) 
; L line b/print 
} No Line advance 
i 3 lines b/print H 
i} 2 lines b/print 1 
| Top of form b/print 
i} Select VFU-2 b/print jj 
|} Select VFU-3 b/print | 
} Select VFU-4 b/print | 
} Select VFU-5 b/print |; 
| Select VFU-6 b/print jj} 
} Select VFU-7 b/print |} 
| Select VFU-8 b/print jj} 
| Select VFU-9 b/print jj; 
{| Select VFU-10 b/print | 
| Select VFU-11 b/print } 
| Select VFU-12 b/print | 
} Ll line a/print H 
| No line advance 
; 3 lines a/print H 
i} 2 lines a/print H 
i Top of form a/print 
| Select VFU-2 a/print | 
| Select VFU-3 a/print jj} 
i Select VFU-4 a/print jj; 
| Select VFU-5 a/print |} 
i Select VFU-6 a/print jj; 
| Select VFU-7 a/print | 
i Select VFU-8 a/print jj; 
| Select VFU-9 a/print j; 
| Select VFU-10 a/print | 
| Select VFU-11 a/print | 
| Select VFU-12 a/print |} 
| No Line advance 
H line b/print H 
H lines b/print H 
H lines b/print H 
i lines b/print H 
| lines b/print 
H lines b/print H 
H lines b/print H 


MAMAANAVARANMKHNNAUNHAPHAP HHL PA LAL HP HPP PW W WW WWW WW WDD ooi1nm 
STMOPWHPORWNPFPOMNMOQOWP,P WO WAIMHMHWNEFUAWANIAONAWNHEOUWO wwo is 
wom ewe em ae ees ee ee ewe ee ee me ee wee ee eee ee wee eee ee ee we WO OO SO SO Se Teo WE we Se @e wea we a mae we 


QMAABAAWM -HNWWVWOAMZEZONRGH TAMIA QWPWABANMMAh®WH-HEO!] +O 3 
NOM PWH PE 
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| OPERATIONS AFFECTING 
LINE SPACING 


= 
Pi 
ae 
Q 
oa 


8 lines b/print 

9 lines b/print 

10 lines b/print 
11 lines b/print 
12 lines b/print 
13 lines b/print 
14 lines b/print 
15 lines b/print 
16 lines b/print 
17 lines b/print 
18 lines b/print 
19 lines b/print 
20 lines b/print 
21 lines b/print 
22 lines b/print 
23 lines b/print 
24 lines b/print 
25 lines b/print 
26 lines b/print 
27 lines b/print 
28 lines b/print 
29 lines b/print 
30 lines b/print 
31 lines b/print 
32 lines b/print 
33 lines b/print 
lines b/print 
35 lines b/print 
36 lines b/print 
37 lines b/print 
38 lines b/print 
39 Lines b/print 
40 lines b/print 
41 lines b/print 
42 lines b/print 
43 lines b/print 
44 lines b/print 
45 lines b/print 
46 lines b/print 
47 lines b/print 
48 lines b/print 
50 lines b/print 
51 lines b/print 
52 lines b/print 
53 lines b/print 
54 lines b/print 
55 lines b/print 
56 lines b/print 
57 lines b/print 
58 lines b/print 
59 lines b/print 


Iw NN KM ESE THONQDODS roe ST 


DEL 


DPUBDIMHTAwWONE AMAOVQWPOBDAANMNMAWNHPEPOMMMDAQDWPYPOABANAMNAFAWNPOMNMTOQADYPWOH 


Ww 
oe 


WWUWUWUUUUOUNWU UU WDDABDAWDWDWOWWAODAAWDAONINANAINNANYNNNNNNYNYYOAMAAAAAAM 
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CHAR LINE SPACING 
[seer ee eee eee eee eee eee eee eee 
;9C |} } 60 lines b/print 
19D } } 61 lines b/print 
i9E } } 62 lines b/print 
}9F | } 63 lines b/print 
}A0 | |} 64 lines b/print 
iAl } } 65 lines b/print 
}A2 | } 66 lines b/print 
{‘A3 | } 67 lines b/print 
(Ad | } 68 lines b/print 
{}A5 | } 69 lines b/print 
1A6 } i 7O lines b/print 
1A7 } } 71 lines b/print 
iA8 |] i} 72 lines b/print 
}A9 j i 73 lines b/print 
i } i 74 lines b/print 
H i ! 75 lines b/print 
}AC } } 76 lines b/print 
H | i} 77 lines b/print 
1 H ; 78 lines b/print 
H 1 } 79 Lines b/print 
1BO } i; No line space 
iBl | i 1 line a/print 
i1B2 } } 2 lines a/print 
1B3 | i 3 lines a/print 
iB4 } i 4 lines a/print 
iBS } : 5 lines a/print 
1B6 | } 6 lines a/print 
iB7 } } 7 lines a/print 
}BS | } 8 lines a/print 
1B9 | } 9 lines a/print 
iBA } | 10 lines a/print 
{BB } } ll lines a/print 
iBC } } 12 lines a/print 
iBD } i 13 lines a/print 
iBE | 1 14 lines a/print 
iBF } i 15 lines a/print 
ico } } 16 lines a/print 
rCci | } 17 lines a/print 
}C2 | } 18 lines a/print 
ic3 | } 19 lines a/print 
}Cc4 | ; 20 lines a/print 
ic5 |} i 21 lines a/print 
1C6 | i 22 lines a/print 
ic7 | ; 23 lines a/print 
ics | | 24 lines a/print 
ic9 | ; 25 lines a/print 
}CA | } 26 lines a/print 
iCB { i 27 lines a/print 
icc | | 28 lines a/print 
1CD } i} 29 lines a/print 
iCE | } 30 lines a/print 
1CF | } 31 lines a/print 
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en eee eee ee wee ees we eee ee eee ee eee ee eee ES ee en ee ee ee eee een er ee een eee ee wee ee ee we wee ease 


t 

| HEX LINE SPACING 
| Serres ester eee ee ee Ee ee Eee 
1DO } | 32 lines a/print 
{Dl | i 33 lines a/print 
1D2 | | 34 lines a/print 
iD2 {| i 35 lines a/print 
1D3 | } 36 lines a/print 
1D4 | | 36 lines a/print 
iD5 | | 37 lines a/print 
iD6 | | 38 lines a/print 
iD7 | | 39 lines a/print 
iD8& } | 40 lines a/print 
iD9 | | 41 lines a/print 
IDA | |} 42 lines a/print 
iDB j } 43 lines a/print 
iDC | |} 44 lines a/print 
iDD | | 45 lines a/print 
{DE | | 46 lines a/print 
}DF | } 47 lines a/print 
iEO | | 48 lines a/print 
{El | | 49 lines a/print 
1E2 | |} 50 lines a/print 
iE3 | ; 5SL lines a/print 
jE4 | } 52 lines a/print 
iES | ' 53 lines a/print 
1E6 | ; 54 lines a/print 
iB7 | i 55 lines a/print 
iE8 | i; 56 lines a/print 
1E9 | | 57 lines a/print 
iEA | i 58 lines a/print 
iEB j } 59 lines a/print 
;EC | | 60 lines a/print 
}ED | | 61 lines a/print 
(EE | i 62 lines a/print 
IEF } 63 lines a/print 
iFO | | 64 lines a/print 
iFl | | 65 lines a/print 
}F2 | } 66 lines a/print 
1F3 | i 67 lines a/print 
iF4 | i 68 lines a/print 
IFS | | 69 lines a/print 
iF6 | ; 7O lines a/print 
1F7 | } 7L lines a/print 
iF8 | | 72 lines a/print 
iF } | 73 lines a/print 
iFA {| | 74 lines a/print 
iFB } i 75 Lines a/print 
iFC j i 76 lines a/print 
iFD | i 77 lines a/print 
iFE | | 78 lines a/print 
iFF {| } 79 lines a/print 


OPERATIONS AFFECTING 


mem ee ee ee ee ee re re ee ee eee ee ree ee eee ee eee ee we we we we we wee ee ee ee ee ee we 
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A 


Account reporting utility 
Accounting transaction file 
Analog input controller 
supported record lengths 
Analog output controller 
Analog to digital converter 
APU. See auxiliary 
processing unit. 
Assigning a task 
LPU mapping 
ATF. See accounting 
transaction file. 
Auxiliary processing unit 


active task 
commands 


configuration options 


control options 


control rights 


error codes 


exclusive task 
hardware status 


initialization 


mapping 
mapping rights 


mark-off 

mar k-on 

monitor task 

number of LPUs 
operating states 
power-up link check 
ready queue 


ready task 
scheduling tasks on 
software status 


start-up 

status 

task execution 
task scheduling 
waiting task 
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B 


Bare disk I/0 
Bare disk privileges 


Basic data communications 
subsystem 
protocols 
BIOC driver 
horizontal tabbing 
Buffer access 


Cc 


Card reader/punch devices 
ASCII operations 


binary operations 


Hollerith code 
translation 


image operations 


supported record lengths 
Card readers 

ASCII operations 

binary operations 

Hollerith code 

translation 

image operations 

supported record lengths 
Central processing unit 

ready queue 


receive queue 


roll-in queue 
Circular list 


Command processor subsystem 
priority level of 
Command substitution system 


Console driver 
Console monitor subsystem 
Contiguous files 


CPU. See central processing 
unit. 
CSS. See command 


substitution system. 
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i 
D | 
{| File account privileges 2-6 
D-tasks 274. | File handlers 5-11 
2-6 H 5-12 
3-20 | File management subsystem 1-12 
3-28 {| Files 1-12 
5-11 {| Floating point subsystem 1-17 
5-12 {| Floppy disk 
Data collection facility 1-9 H random reads 512° 
Data management system 1-2 { random writes 5-12 | 
Data structures 2-3 | sequential reads 5-12 | 
Designing tasks { sequential writes 5-12 | 
simultaneous processing 6-1 { supported record lengths §-12 | 
Device dependent [/0 1-14 | 
Device drivers 1-17 
Device independent I[/0 1-14 | G : 
Diagnostic tasks. See { 
d-tasks. | Gapless [/0 oe oy ee 
Digital I/O controller | Global task common 1-10 | 
binary operations 5-15 {| GSIG instruction 6-11 
5-16 | 
Digital multiplexor 5-13 | ; 
Disk devices | H 
random reads 5-11 | ; 
random writes 5-11 {| Hardware-echo 5-2 
retry on error 5-11 {| Horizontal tabbing oat Ce 
sequential read 5-1ll | 5-2 | 
sequential writes S=11. 4 
supported record lengths 5-1ll- 3 : 
Disk directory 3-28 | I 
Dispatch priority L=5 | : 
DMS/32. See data management | 1/0 operations dS 
system. } I/0 subsystem L=12: 
Dynamic scheduling i=5 | L-i5 
Dynamic time-slice 1-6 { ICONT 4-27 |. 
1-7 | use of 4-13 | 
{| ICREATE 4-16 | 
H use of 4-8 | 
E } IERRTST 4-34 © 
| use of 4-14 
E-tasks 221 | IGET 4-24 
3-20 | use of 4-12 
3-23 | Impure segment 1-14 
3-25 | Indexed files 5-11 
3-26 | 5-12 
3-28 | Input/output. See I/O. 
5-11 | Instrument Society of America 5-15 
characteristics of 2-2 | Integrated transaction 
data structures 2-3 | controller 1-2 
programming of 2-2 {| Intercept macros 4-1 
2-3 | error codes 4-15 
Error code byte 3-50 |} ICONT 4-25 
3-53 | ICREATE 4-16 
3-54 | IERRTST 4-34 
Error log hardware 1-13 | IGET 4-24 
Error recording subsystem rears. «| I PROCEED 4-28 
Error reporting utility 1-13 | IPUT 4-26 
Executive tasks. See ; | I REMOVE 4-22 
e-tasks. H IROLL 4-29 
Extendable contiguous files 5-11. oj ITERM 4-30 
B= 12). 44 ITRAP 4-32 
Extended close function 3-28 | Intercept path 4-4 
| 4-8 
H 4-9 
H end of task operation 4-13 
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Intercept path (Continued) 
example 
full control 


identifier 
monitor control 
programming guidelines 
removing 

Intercepting task 


use with MIM 
Internal interrupt subsystem 
Internal reader 


command buffers 
Interval timer queue 
IPROCEED 

use of 
IPUT 

use of 
IREMOVE 

use of 
[ROLL 

use of 
ISA. See Instrument Society 
of America. 
ITC. See integrated 
transaction controller. 
ITERM 

use of 
ITRAP 


J,K 


Job accounting subsystem 


L 


LFC. See line frequency 
clock. 
LIB. See loader information 
block. 
Line frequency clock 
Line printer driver 
horizontal tabbing 
Line printers 
ASCII operations 
byte limit of transfer 
erasing of 
gapless I/O 
image operations 
read operations 
recording density 
retry on error 
standard I[/0O 
supported record lengths 
write operations 
Loader and segmentation 
subsystem 
Loader information block 
Local memory 
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Logical processing unit 


Logical processor mapping 
table 


LPMT. See logical processor 
mapping table. 

LPU number 

LPU. See logical processing 
unit. 


M 


Magnetic tape 
Maximum priority 
Memory 
types of 
Memory conflicts 
buffer access 
system deadlock 
test and set 
Memory diagnostics subsystem 
Memory management subsystem 
Memory map 
Model 3200MPS System 


assigning a task 
designing tasks for 
memory conflicts 
performance advantage 
real-time performance 
task rescheduling 
task scheduling 


MIM. See multi-terminal 
monitor. 
Multi-terminal monitor 


N 


Non-privileged instructions 
Non-privileged u-tasks 
Nonbuffered indexed files 


0S/32 
account reporting 
basic data communications 
command processor 
console monitor 
Gata collection facility 
data structures 
error recording 
file management 
I/O operations 
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OS/32 (Continued) 
interrupt servicing 
job accounting 
linkage editor 
loader and segmentation 
memory diagnostics 
memory management 
multiprocessing support 
optional supervisor call 
roll function 
software support summary 
subsystems 
supervisor calls 
supported [/O devices 


system initialization 
task management 

timer management 
virtual task manager 


P,Q 


Paper tape equipment 
ASCII operations 
binary operations 
image operations 
supported record lengths 


PIC. See precision interval 
clock. 
Power-up link check 


Precision interval clock 
Private segment table 
Privileged instructions 


Privileged operating state 
Privileged tasks 


extended SVC 7 function 
codes 
types of 
Privileged u-tasks 


Program status word 


device 
of generic 
task 

use of generic 
PST. See private 
table. 
Pure segment 


Pseudo 
use 
Pseudo 


naming 


naming 
segment 


R 


RDB. See request descriptor 
block. 


Ready queue 


Real-time performance 
timer macros 
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Receive queue 


Reliance 
Relocation/protection 
hardware 


programming of 
Request descriptor block 
buffers 


fields 
Response byte 
bit definitions 


Roll function 
Roll-in queue 


RSCH instruction 
RTSM 
Run priority 


Ss 


SCL. 
list. 

Segment control list 

Shared memory 

Software density selection 


See segment control 


SPT. See system pointer 
table. 
Standard I[/0 
parity error 
record gap 
supported record lengths 
Supervisor call interception 
caller mode 
creating intercept paths 
error handling 
functional summary 
macros 
operation of 


recipient existent mode 
recipient nonexistent 
mode 

rollable tasks 

sample programs 


task preparation for 
termination of 


Supervisor calls. See SVC. 
SVC 
Svc 0 
svc l 
interception 
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svc 13 
APU rescheduling 
control sequence 
error status codes 


example of 


function codes 
mapping functions 
task scheduling 
use of 


SVC 13 code 0 
coding 
data buffer format 
parameter block 
SVC 13 code 1 


coding 
Gata buffer format 
parameter block 
SVC 13 code 2 
coding 
option coding sequences 
options 
parameter block 
SVC 13 code 3 


coding 
control options 


option coding sequences 
parameter bliock 
Svc 14 
SVC 2 code 0 
coding 
functional details 
parameter block 
SVC 2 code 14 
coding for option 0 
coding for option 1 
example 
parameter block for 
option 0 
parameter block for 
option 1 
programming 
considerations 
status codes 
SVC 2 code 23 


SVC 2 code 26 
coding 
condition codes 
example 
parameter block 

SVC 2 code 27 
coding 
condition codes 
option codes 
parameter block 
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SVC 2 code 7 
interception 


SVC 3 
interception 


SVC 6 
example of 


interception 


loading a task 
suspend task 
SVC 6 system task release 
coding 
parameter block 
Svc 7 
interception 


SVC 7 bare disk assignment 
coding 
parameter block 
SVC 7 code 0 
coding 
parameter block 
SVC 7 code X'FF80' 
coding 
parameter block 
SVC 7 device rename 
coding 
parameter block 
SVC 7 device reprotect 
coding 
parameter block 
System deadlock 
avoiding 
System initialization 
subsystem 
System journal 
System memory 
System pointer table 
System task 
System time-slice 


T 


Tape cassette 
ASCII operations 
binary operations 
continuous mode 
operations 
image operations 
supported record lengths 
Task 
dynamic scheduling 
execution state 
impure segment 
priority levels 
pure segment 
user execution state 
Task common 
Task control block 


Task event trap 
handler 
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Task event trap (Continued) Timer macros (Continued) 


register saving 4-8 READTCNT 6-14 
Task image 1-13 RESET IME 6-14 
1-14 STRT IME 6-14 
Task management L=5 Timer management subsystem L=1iL 
Task priority i=5 Timer queues Lod L 
Task priority levels TQ. See timer queues 
dispatch e=5 TSW. See task status word. 
max imum 1-5 TTY. See teletype. 
run 1-5 
1-7 
task 1-5 U 
Task queue trap 4-12 
Task rescheduling U-tasks 2-1 
connecting the APU, 5-11 
example of 6-7 5-12 
connecting the APU, non-privileged 2=5 
parameters = priviledged 2-5 
GSIG instruction -11 Universal clock 1-11 


| 


monitoring and preempting 
RSCH instruction 
task queue, example of 
transferring a task 
trap handling 
verifying task transfer 
Task segment table 
Task status word 
CPU override status bit 


User supervisor call 
subsystem 1-17 
User tasks. See u-tasks. 
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VDU. See video display unit. 
Verifying task transfer to 


Task transfer an APU 
example of 6-12 example of 6-11 
from APU to CPU 6-12 Vertical forms control 

Task traps 1-7 functions of S=L 

1-13 supported characters 5=1 
ston Wd B-1 

TCB. See task control block. theory of operating 5-2 

Teletype keyboard/printer VFC. See vertical forms 
ASCII operations 5-7 control. 
image operations 5-8 Video display unit 
supported record lengths = Ease ASCII operations 5-12 

Teletype reader/punch image operations 5-13 
ASCII operations 5-6 supported record lengths 5-12 

5-7 Virtual task manager 1-1 
binary operations 5-6 Volume mnemonic table 3-12 
S=7 VIM. See virtual task 
image operations 5-7 manager . 
supported record lengths 5-6 

Test and set 6-13 
example of 6-14 W-Z 

Time of day queue 1-11 

Time-slicing WCS. See writable control 
types of 1-6 store. 

Timer macros Writable control store 3-35 
CRTIMERS 6-14 
example of 6-15 
GET IME 6-14 8-line interrupt module 5-13 | 


em mm cee ee ee ee ee ee me ee ee ee em ee ee ee ee ee me ee ee ee ee ee ee ee ee ee ee ee ee re ee we ee ee ee em re me ee eee ee ee ee ee ee ee we Se ee ee we oe oe 


IND~-6 48-040 FOO ROZ 


CUT ALONG LINE 


PUBLICATION COMMENT FORM 


Please use this postage-paid form to make any comments. suggestions. criticisms, etc. concerning 
this publication. 


From Date 
Title Publication Title 
Company Publication Number 
~ Address 
FOLD FOLD 


Check the appropriate item. 

CJ Error Page No. —_______ __ Drawing No. 
["] Addition Page No..._.______— Drawing No. 
‘- Other Page No... —éi@ rawiirngs NNO. 


Explanation: 


FOLD FOLD 


Fold and Staple 


No postage necessary if mailed in U.S.A. 
6434 


STAPLE STAPLE 


NO POSTAGE 
NECESSARY 
IF MAILED 


IN THE | 
UNITED STATES || 


| BUSINESS REPLY MAIL 


FIRST CLASS PERMIT NO. 22 OCEANPORT, N.J. 


POSTAGE WILL BE PAID BY ADDRESSEE 


PERKIN-ELMER ac 


2 Crescent Place 
Oceanport, NJ 07757 


TECH PUBLICATIONS DEPT. MS 322A 


a sc ee a ER oe es a ON a a a gy a ee ee as es 
FOLD FOLO | 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

pe 

STAPLE STAPLE | 
| 


PERK IN-EI.MER 
Technical Systems Division 


DOCUMENTATION CHANGE NOTICE 
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e Page 3-38 


Th ee 


to 
to 


Under APU software status, replace the statement, “status 


after the last power fail", to “previous status". 


e@ Page 3-38 


Add the following paragraph to APU software status: 


The “previous status" would be returned in the caller's 


buffer when the following occurs: 


@ Global power failure 
e Local APU power failure 
@ APU hardware failure 


e RTSM Link failure 


e Page 3-38 


In Figure 3-16, replace "Last power failure status" with 


“previous status". 


@ Page 3-39 


In Table 3-4 replace "Last power failure’ status" with 


“previous status". 
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